IHttpNegotiate::BeginningTransaction
A version of this page is also available for
4/8/2010
This method notifies the client of the URL being bound to at the beginning of an HTTP transaction.
Syntax
HRESULT BeginningTransaction(
LPCWSTR szURL,
DWORD dwReserved,
LPCWSTR szHeaders,
LPWSTR* pszAdditionalHeaders
);
Parameters
- szURL
[in] Address of a string value that contains the URL for this HTTP transaction.
- dwReserved
[in] Reserved.
- szHeaders
[in] Address of a string value that contains the current request headers.
- pszAdditionalHeaders
[out] Address of a pointer to a string variable that contains additional headers to append to the HTTP request. If these conflict with existing values in szHeaders, the new request headers take precedence. If pszAdditionalHeaders is set to NULL, no headers are added to the HTTP request.
Return Value
This method returns one of the values that are shown in the following table.
| Value | Description |
|---|---|
S_OK |
The HTTP transaction completed successfully and any additional headers specified have been appended. |
E_ABORT |
The HTTP transaction was terminated. |
E_INVALIDARG |
A parameter is invalid. |
Remarks
The URL moniker calls this method before it sends an HTTP request. It notifies the client of the URL being bound to at the beginning of the HTTP transaction. It also allows for the client to add more headers, such as Accept-Language, to the request.
Requirements
| Header | urlmon.h, urlmon.idl |
| Library | urlmon.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |