Export (0) Print
Expand All

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 codeDescription
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

See also

IHttpNegotiate

 

 

Show:
© 2014 Microsoft