Share via


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

See also

IHttpNegotiate