WriteClient

  • Article

The WriteClient callback function is called by an ISAPI filter to send data to the client.

BOOL WINAPI * WriteClient(
   PHTTP_FILTER_CONTEXT pfc,
   LPVOID buffer,
   LPDWORD lpdwBytes,
   DWORD dwReserved
);

Parameters

  • pfc
    Points to the HTTP_FILTER_CONTEXT Structure that is associated with the current, active HTTP transaction.

  • buffer
    A buffer containing data to send to the client.

  • lpdwBytes
    The size of the buffer pointed to by buffer.

  • dwReserved
    Reserved for future use.

Return Values

Returns true if the function was successful; otherwise false. The GetLastError function indicates the reason for failure. The most common reason is as follows:

Return code

Description

ERROR_INVALID_PARAMETER

If pfc or the server context that pfc points to is invalid. Additionally, if the header name does not end with a colon (:).

ERROR_NOT_SUPPORTED

If the header is not supported by the HTTP version.

Remarks

If you are using IIS version 3.0 or later, and you attempt to send more than 16 KB of data over an SSL connection, IIS will automatically break your outgoing data into multiple chunks of 16 KB or smaller.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in httpfilt.h.