Platform SDK: SMTP Server Events

IMailMsgRecipients::InitializeRecipientFilterContext

[This is preliminary documentation and subject to change.]

Initialize a recipient filter context against a chain of domain.

HRESULT InitializeRecipientFilterContext(
[in,unique] LPRECIPIENT_FILTER_CONTEXT pContext,
[in] DWORD dwStartingDomain,
[in] DWORD dwFilterFlags,
[in] DWORD dwFilterMask
);
pContext
Specifies the context variable to be initialized. The caller must allocate this context.
dwStartingDomain
Specifies the starting domain index.
dwFilterMask
Specifies the filter mask. This mask will mask out the bits of interest in IMMPID_RP_STATUS_FLAGS before checking the filter flags.
dwFilterFlags
Specifies the filter flags. These flags are compared against the result of the mask, and an exact match is required.

Return Values

Value Description
S_OK Success.
E_INVALIDARG Failure. One or more arguments are invalid.
E_POINTER Failure. The context passed in is NULL.

Remarks

Filter is based on comparing a set of filter flags against the IMMPID_RP_STATUS_FLAGS property.

See Also