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 combines a base URL and a relative URL into a single full URL.

Syntax 

HRESULT CombineUrl(
  LPCWSTR 
pwzBaseUrl,
  LPCWSTR 
pwzRelativeUrl,
  DWORD 
dwCombineFlags,
  LPWSTR 
pwzResult,
  DWORD 
cchResult,
  DWORD* 
pcchResult,
  DWORD 
dwReserved
);

Parameters

pwzBaseUrl

[in] String value containing the base URL.

pwzRelativeUrl

[in] String value containing the relative URL.

dwCombineFlags

[in] Unsigned long integer value that controls the combining process. Can be one of the following values:

  • ICU_ENCODE_SPACES_ONLY

  • ICU_NO_ENCODE

  • ICU_NO_META

pwzResult

[out] String variable where the full URL will be stored.

cchResult

[in] Unsigned long integer value that contains the size of the buffer.

pcchResult

[out] Address of an unsigned long integer value to store the size of the information stored in the buffer.

dwReserved

[in] Reserved. Must be set to zero.

Return Value

Returns S_OK if successful or S_FALSE if the buffer is too small to contain the resulting URL.

Remarks

For more information on the dwCombineFlagsvalues, see the InternetCombineUrlfunction in the WinInetAPI.

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