NAME¶

UrlCanonicalizeA (SHLWAPI.@)

SYNOPSIS¶

HRESULT UrlCanonicalizeA
(
LPCSTR pszUrl,
LPSTR pszCanonicalized,
LPDWORD pcchCanonicalized,
DWORD dwFlags
)

DESCRIPTION¶

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".