Microsoft Internet Security and Acceleration Server 2004 SDK

SF_REQ_DISABLE_WPX_NOTIFICATIONS

The SF_REQ_DISABLE_WPX_NOTIFICATIONS form of the WPXSupportFunction callback function can be used to disable notification types specific to ISA Server 2004 for your Web filter for the remaining lifetime of a request. If a particular notification event is disabled for your filter, the ISA Server Web proxy will not call your filter when that notification event occurs.

This function does not affect new requests, even in the same session.

BOOL WINAPI * ServerSupportFunction(
  struct _HTTP_FILTER_CONTEXT* pfc,
  enum SF_REQ_TYPE sfReq,
  PVOID pData,
  DWORD ul1,
  DWORD ul2
);

Parameters

pfc
Pointer to the HTTP_FILTER_CONTEXT data structure that is associated with the current, active HTTP session. Pass the filter context in this parameter.
sfReq
Specifies the particular support function that is to be executed by the ISA Web filter, in this case, SF_REQ_DISABLE_WPX_NOTIFICATIONS.
pData
Unused in this support function.
ul1
Contains flags, listed in the Remarks section, that indicate which notification types are to be disabled.
ul2
Unused in this support function.

Return Values

Returns TRUE if the function succeeded, or FALSE if the function failed.

Remarks

This callback function disables the following notifications:

The WPXSupportFunction function is called through a pointer that is a member of the WPX_FILTER_CONTEXT structure. To get a pointer to the WPX_FILTER_CONTEXT structure for calling the WPXSupportFunction function, use the TO_WPX_FILTER_CONTEXT macro as follows:

WPX_FILTER_CONTEXT* pwfc = TO_WPX_FILTER_CONTEXT(pfc);
if (pwfc != NULL) {
...
}
For more information about the types of event notifications that are sent to Web filters, see Event Notifications.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wpxhttpfilt.h.

See Also

WPXSupportFunction