UrlEscapeW3w

Usage

Overview

Converts unsafe characters in a Url into escape sequences.

Params

pszUrl [In] Url to modify.

pszEscaped [Out] Destination for modified Url.

pcchEscaped [In/Out] Length of pszUrl, destination for length of pszEscaped.

dwFlags [In] URL_ flags from "shlwapi.h".

Returns

Success: S_OK. pszEscaped contains the escaped Url, pcchEscaped contains its length.

Failure: E_POINTER, if pszEscaped is not large enough. In this case pcchEscaped is set to the required length.

Converts unsafe characters into their escape sequences.

Notes

- By default this function stops converting at the first '?' or '#' character.

- If dwFlags contains URL_ESCAPE_SPACES_ONLY then only spaces are converted, but the conversion continues past a '?' or '#'.

- Note that this function did not work well (or at all) in shlwapi version 4.

Implementation

Declared in "shlwapi.h".

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

Debug channel "shell".