HttpAddRequestHeadersA function (wininet.h)
Adds one or more HTTP request headers to the HTTP request handle.
BOOL HttpAddRequestHeadersA( [in] HINTERNET hRequest, [in] LPCSTR lpszHeaders, [in] DWORD dwHeadersLength, [in] DWORD dwModifiers );
A handle returned by a call to the HttpOpenRequest function.
A pointer to a string variable containing the headers to append to the request. Each header must be terminated by a CR/LF (carriage return/line feed) pair.
The size of lpszHeaders, in TCHARs. If this parameter is -1L, the function assumes that lpszHeaders is zero-terminated (ASCIIZ), and the length is computed.
A set of modifiers that control the semantics of this function. This parameter can be a combination of the following values.
Returns TRUE if successful, or FALSE otherwise. To get extended error information, call GetLastError.
HttpAddRequestHeaders appends additional, free-format headers to the HTTP request handle and is intended for use by sophisticated clients that need detailed control over the exact request sent to the HTTP server.
Note that for basic HttpAddRequestHeaders, the application can pass in multiple headers in a single buffer. If the application is trying to remove or replace a header, only one header can be supplied in lpszHeaders.
The wininet.h header defines HttpAddRequestHeaders as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|