Otherwise, a standard error value is returned. If the pcchEscaped buffer was too small to contain the result, E_POINTER is returned, and the value pointed to by pcchEscaped is set to the required buffer size. Percent-encode all ASCII characters outside of the unreserved set from URI RFC 3986 (a-zA-Z0-9-.~_).
Percent-encode all non-ASCII characters as their UTF-8 equivalents. This flag cannot be combined with URL_ESCAPE_SPACES_ONLY or URL_DONT_ESCAPE_EXTRA_INFO.
ESCAPE BY FOCUSLIST FOR WINDOWS FULL
If a full URL is provided when this flag is set, all unsafe characters in the entire string are converted, including # and ? characters.Ĭombine this flag with URL_ESCAPE_PERCENT to include that character in the conversion. All unsafe characters in the string are converted. Indicates that pszURL contains only that section of the URL following the server component but preceding the query. This flag cannot be combined with URL_ESCAPE_SPACES_ONLY. However, as the URL_ESCAPE_SEGMENT_ONLY flag causes the entire string to be considered the segment, any # or ? characters are also converted. Other unsafe characters in the segment are also converted normally.Ĭombining this flag with URL_ESCAPE_SEGMENT_ONLY includes those % characters in the query portion of the URL. By default, the % character is not converted to its escape sequence. URL_ESCAPE_PERCENT (0x00001000)Ĭonvert any % character found in the segment section of the URL (that section falling between the server specification and the first # or ? character). This flag cannot be combined with URL_ESCAPE_PERCENT or URL_ESCAPE_SEGMENT_ONLY. It expects only the portions following the server specification.Ĭombine this flag with URL_DONT_ESCAPE_EXTRA_INFO to prevent the conversion of space characters in the query portion of the URL. This flag assumes that pszURL does not contain a full URL. Other unsafe characters are not converted to their escape sequences. URL_ESCAPE_SPACES_ONLY (0x04000000)Ĭonvert only space characters to their escape sequences, including those space characters in the query portion of the URL. URL_BROWSER_MODEĭefined to be the same as URL_DONT_ESCAPE_EXTRA_INFO.
This flag should not be used alone, nor combined with URL_ESCAPE_SEGMENT_ONLY. Used only in conjunction with URL_ESCAPE_SPACES_ONLY to prevent the conversion of characters in the query (the portion of the URL following the first # or ? character encountered in the string). The flags that indicate which portion of the URL is being provided in pszURL and which characters in that string should be converted to their escape sequences. If any other errors are returned, the value referenced by pcchEscaped is undefined.
ESCAPE BY FOCUSLIST FOR WINDOWS CODE
If an E_POINTER error code is returned, the buffer was too small to hold the result, and the value referenced by pcchEscaped is set to the required number of characters in the buffer. When this function returns successfully, the value receives the number of characters written to the buffer, not including the terminating NULL character. Before calling UrlEscape, the calling application must set the value referenced by pcchEscaped to the size of the buffer. The buffer that receives the converted string, with the unsafe characters converted to their escape sequences.Ī pointer to a DWORD value that, on entry, contains the number of characters in the pszEscaped buffer.
Syntax LWSTDAPI UrlEscapeA(Ī null-terminated string of maximum length INTERNET_MAX_URL_LENGTH that contains a full or partial URL, as appropriate for the value in dwFlags. Surrogate pairs are characters between U+10000 to U+10FFFF (in UTF-32) or between DC00 to DFFF (in UTF-16). Converts characters or surrogate pairs in a URL that might be altered during transport across the Internet ("unsafe" characters) into their corresponding escape sequences.
0 kommentar(er)
