IHttpNegotiate::BeginningTransaction

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

IHttpNegotiate::OnResponse

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
);