IInternetProtocolInfo::CombineURL

Combines a base and relative URL into a 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_BROWSER_MODE, 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 Values

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 dwCombineFlags values, see the InternetCombineUrl function in the WinInet API.

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: urlmon.h
Library: urlmon.lib

Share via