Notifies the client of the URL being bound at the beginning of an HTTP transaction.
HRESULT BeginningTransaction(
LPCWSTR
szURL, //URL for the HTTP transaction
DWORD dwReserved, //Reserved for future use
LPCWSTR szHeaders, //Current request headers
LPWSTR *pszAdditionalHeaders //Optional additional headers to append to the HTTP request header
);
Parameter
szURL
[in] URL for the HTTP transaction.
dwReserved
[in] Reserved for future use.
szHeaders
[in] Current request headers.
pszAdditionalHeaders
[out] Optional additional headers to append to the HTTP request. If these conflict with existing values in szHeaders, then the new request headers take precedence. If pszAdditionalHeaders is set to NULL, no headers are added to the HTTP request.
Return Values
S_OK
The operation was successful. Any additional headers specfied are appended.
E_INVALIDARG
The parameter is invalid.
E_ABORT
Terminate the HTTP transaction.
Remarks
The URL moniker calls IHttpNegotiate::BeginningTransaction before sending an HTTP request. It notifies the client of the URL being bound to at the beginning of the HTTP transaction. It also allows the client to add additional headers, such as Accept-Language, to the request.
See Also