Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method notifies the client of the URL being bound to at the beginning of an HTTP transaction.

Syntax 

HRESULT BeginningTransaction(
  LPCWSTR 
szURL,
  DWORD 
dwReserved,
  LPCWSTR 
szHeaders,
  LPWSTR* 
pszAdditionalHeaders
);

Parameters

szURL

[in] Address of a string value that contains the URL for this HTTP transaction.

dwReserved

[in] Reserved.

szHeaders

[in] Address of a string value that contains the current request headers.

pszAdditionalHeaders

[out] Address of 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 pszAdditionalHeadersis set to NULL, no headers are added to the HTTP request.

Return Value

This method returns one of the values that are shown in the following table.

Value Description

S_OK

The HTTP transaction completed successfully and any additional headers specified have been appended.

E_ABORT

The HTTP transaction was 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 being bound to at the beginning of the HTTP transaction. It also allows for the client to add more headers, such as Accept-Language, to the request.

Requirements

Header urlmon.h, urlmon.idl
Library urlmon.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also