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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in urlmon.h.