nn::http::Connection::GetHeaderAll Member Function

nn::Result GetHeaderAll(
     char * pHeaderBuf,
     size_t bufSize,
     size_t * pLengthCourier = NULL
) const;

	Name	Description
out	pHeaderBuf	Buffer that stores the message header.
in	bufSize	Data size of pHeaderBuf.
out	pLengthCourier	Buffer that stores the size of the message header. This argument can be omitted if the size of the message header is not required.

Returns the result of the operation. (The results definition is the same as for GetHeaderField.)

Gets the message header for the HTTP response that was received.

This function will block until the header is completely received. See the description of GetHeaderField for more details about this specification.

Note: If the pHeaderBuf size is smaller than the header size, as much data is stored in pHeaderBuf as will fit, and the header size is stored in pLengthCourier.

Note: If pHeaderBuf==NULL or bufSize==0, and if pLengthCourier!=NULL, the field length is stored in pLengthCourier. Note: Unlike GetHeaderAll, this function does not have an attached timeout. In other words, the process will not return from this function until processing has ended.
For this reason, in environments where communications are slow you can expect a long time to pass before the process ends and returns from this function.

2010/06/14

Initial version.