UrlCanonicalizeA(3w)

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

Defined in "shlwapi.h".

Implemented in "build/buildd-wine-unstable_1.1.32-1+b1-amd64-KnxYu0/wine-unstable-1.1.32/build32/dlls/shlwapi/url.c".

Debug channel "shell".

Wine API Aug 2010 UrlCanonicalizeA(3w)