Microsoft Internet Security and Acceleration Server 2004 SDK

SF_REQ_SET_NEXT_READ_SIZE

The SF_REQ_SET_NEXT_READ_SIZE form of the ServerSupportFunction callback function is used by raw-read Web filters to set the number of bytes that will be read during the next read event.

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 Server Web filter, in this case, SF_REQ_SET_NEXT_READ_SIZE.
pData
Unused in this support function.
ul1
Specifies the maximum size, in bytes, that will be read during the next read event.
ul2
Unused in this support function.

Return Values

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

Remarks

This support function is meaningful only for filters that respond to raw-read notifications and that return the status code SF_STATUS_REQ_READ_NEXT from their entry-point function HttpFilterProc.

This support function is not relevant to the implementation of ISAPI in ISA Server. It is provided for compatibility with Internet Information Services (IIS). If you use it in an ISA Server Web filter, you should not assume that the number of bytes read during the subsequent read operation will not exceed the value set in the ul1 parameter.

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

ServerSupportFunction