IHttpNegotiate::BeginningTransaction method
Notifies the client of the URL that is being bound to at the beginning of an HTTP transaction.
Syntax
HRESULT BeginningTransaction(
[in] LPCWSTR szURL,
[in] LPCWSTR szHeaders,
[in] DWORD dwReserved,
[out] LPWSTR *pszAdditionalHeaders
);
Parameters
szURL [in]
The address of a string value that contains the URL for this HTTP transaction.szHeaders [in]
The address of a string value that contains the current request headers.dwReserved [in]
pszAdditionalHeaders [out]
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
Returns one of the following values.
| Return code | Description |
|---|---|
| S_OK | The HTTP transaction completed successfully and any additional headers specified have been appended. |
| E_ABORT | The HTTP transaction has been 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 that is being bound to at the beginning of the HTTP transaction. It also enables the client to add additional headers, such as Accept-Language, to the request.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows Server 2003 |
Product |
Internet Explorer 4.0 |
DLL |
Urlmon.dll |