Share via

CHttpServerContext::ReadClient

  • Article

BOOL ReadClient( LPVOID lpvBuffer**, LPDWORD** lpdwSize );

Return Value

Nonzero if successful, otherwise 0. If the socket used by the server to listen to the client is closed, it will return nonzero, but with zero bytes read.

If the call fails, the Windows function may be called to determine the cause of the error.

Parameters

lpvBuffer

Pointer to the buffer area to receive the requested information.

lpdwSize

Pointer to DWORD indicating the number of bytes available in the buffer. On return *lpdwSize will contain the number of bytes actually transferred into the buffer.

Remarks

Call this member function to read information from the body of the Web client's HTTP request into the buffer supplied by the caller. ReadClient might be used to read data from an HTML form that uses the POST method. If more than *lpdwSize bytes are immediately available to be read, ReadClient will return after transferring that amount of data into the buffer. Otherwise it will block incoming data and wait for buffer space to become available.

CHttpServerContext Overview |  Class Members |  Hierarchy Chart

See Also   CHttpServerContext::WriteClient