UrlCanonicalizeA3w

Usage

Overview

Canonicalize a Url.

Params

pszUrl [In] Url to cCanonicalize.

pszCanonicalized [Out] Destination for converted Url.

pcchCanonicalized [In/Out] Length of pszUrl, destination for length of pszCanonicalized.

dwFlags [In] Flags controlling the conversion.

Returns

Success: S_OK. The pszCanonicalized contains the converted Url.

Failure: E_POINTER, if *pcchCanonicalized is too small.

MSDN incorrectly describes the flags for this function. They should be:

URL_DONT_ESCAPE_EXTRA_INFO 0x02000000

URL_ESCAPE_SPACES_ONLY 0x04000000

URL_ESCAPE_PERCENT 0x00001000

URL_ESCAPE_UNSAFE 0x10000000

URL_UNESCAPE 0x10000000

URL_DONT_SIMPLIFY 0x08000000

URL_ESCAPE_SEGMENT_ONLY 0x00002000

Implementation

Declared in "shlwapi.h".

Implemented in "dlls/shlwapi/url.c".

Debug channel "shell".