EAS calls SvrFilterProc entry point function whenever a notification event for a registered filter occurs. EAS uses this function to pass information and control EAS filter.
DWORD WINAPI SvrFilterProc( DWORD NotificationType, SVRFILTERCONTEXT *pCtx )
Parameter
NotificationType[in]
This parameter indicates current notification type.
SVR_FILTER_CONNECTION | It occurs when a TCP/IP connection request is got by any service of server. |
SVR_FILTER_GLOBAL | It occurs when an incoming message arrived at SMTP service or an outgoing message was sent by SMTP service. |
SVR_FILTER_INBOUND | It occurs when an incoming message arrived to SMTP service. |
SVR_FILTER_OUTBOUND | It occurs when an outgoing message is ready to be relayed by SMTP service. |
SVR_FILTER_INBOX | It occurs when an incoming message is ready to be put into an user INBOX mailbox. |
pCtx[in,out]
This parameter is a pointer of SVRFILTERCONTEXT structure which contains necessary information for the filter. The filter needs those information to process and returns value to EAS. To learn more, please refer to the introduction of SVRFILTERCONTEXT structure.
Return Value
The return value must be SVR_FILTER_NOTIFICATION_END or SVR_FILTER_NEXT_NOTIFICATION. If return value is SVR_FILTER_NEXT_NOTIFICATION, the next filter in the notification chain will be called. Otherwise, EAS won't process the next filter.
See Also