CoInternetCombineUrlEx function
Combines a base URL and a relative URL into a full Uniform Resource Identifier (URI).
Syntax
HRESULT CoInternetCombineUrlEx(
IUri *pBaseUri,
LPCWSTR pwzRelativeUrl,
DWORD dwCombineFlags,
IUri **ppCombinedUri,
_Reserved_ DWORD_PTR dwReserved
);
Parameters
pBaseUri
A pointer to an IUri interface containing the base URI.
pwzRelativeUrl
A pointer to a string value containing the relative URL.
dwCombineFlags
An unsigned long integer value that combines one or more of the following flags.
URL_DONT_SIMPLIFY
Equivalent to Uri_CREATE_NO_CANONICALIZE.
URL_DONT_UNESCAPE_EXTRA_INFO
Equivalent to Uri_CREATE_NO_DECODE_EXTRA_INFO.
URL_FILE_USE_PATHURL
Equivalent to Uri_CREATE_FILE_USE_DOS_PATH.
ppCombinedUri
A pointer to an IUri interface that receives the newly created combined URI. The client must call Release on the returned pointer.
dwReserved
Reserved. Must be set to 0.
Return value
Returns one of the following values.
Return code | Description |
---|---|
S_OK | Success. |
INET_E_INVALID_URL | URI syntax error in pwzRelativeUrl. |
E_OUTOFMEMORY | There is insufficient memory to create the new IUri. |
Remarks
Use this function to combine an IUri and a relative URL stored as a Unicode string value. To combine two IUri objects, use the CoInternetCombineIUri function.
Requirements
Minimum supported client |
Windows XP with SP2 |
Minimum supported server |
Windows Server 2003 with SP1 |
Product |
Internet Explorer 7 |
Header |
Urlmon.h |
Library |
Urlmon.lib |
DLL |
Urlmon.dll |