CreateUri(3w) · carta

Usage

HRESULT CreateUri
(
LPCWSTR pwzURI,
DWORD dwFlags,
DWORD_PTR dwReserved,
IUri** ppURI
)

Overview

Creates a new IUri object using the URI represented by pwzURI. This function parses and validates the components of pwzURI and then canonicalizes the parsed components.

Params

pwzURI [In] The URI to parse, validate, and canonicalize.

dwFlags [In] Flags which can affect how the parsing/canonicalization is performed.

dwReserved [In] Reserved (not used).

ppURI [Out] The resulting IUri after parsing/canonicalization occurs.

Returns

Success: Returns S_OK. ppURI contains the pointer to the newly allocated IUri.

Failure: E_INVALIDARG if there are invalid flag combinations in dwFlags, or an invalid parameter, or pwzURI doesn't represent a valid URI. E_OUTOFMEMORY if any memory allocation fails.

Notes

Default flags: Uri_CREATE_CANONICALIZE, Uri_CREATE_DECODE_EXTRA_INFO, Uri_CREATE_CRACK_UNKNOWN_SCHEMES, Uri_CREATE_PRE_PROCESS_HTML_URI, Uri_CREATE_NO_IE_SETTINGS.

Implementation

Declared in "urlmon.h".

Implemented in "dlls/urlmon/uri.c".

Debug channel "urlmon".