WriteClient
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.