SvrFilterProc


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

GetFilterVersion function