Manager.URL_CANONFLAGS Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Specifies how a URL is converted to canonical form.
This API supports the product infrastructure and is not intended to be used directly from your code.
public: enum class Manager::URL_CANONFLAGSpublic enum Manager.URL_CANONFLAGStype Manager.URL_CANONFLAGS = Public Enum Manager.URL_CANONFLAGS- Inheritance
Fields
| Name | Value | Description |
|---|---|---|
| URL_WININET_COMPATIBILITY | -2147483648 | Merge all the parameters to create a full URL. |
| URL_ESCAPE_PERCENT | 4096 | Convert any occurrence of "%" to its escape sequence. |
| URL_ESCAPE_SEGMENT_ONLY | 8192 | Indication that the URL contains only the section following the server component but preceding the query. All unsafe characters in the string are converted. If a full URL is provided when this flag is set, all unsafe characters in the entire string are converted, including # and ? characters. Combine this flag with URL_ESCAPE_PERCENT to include that character in the conversion. This flag cannot be combined with URL_ESCAPE_SPACES_ONLY or URL_DONT_ESCAPE_EXTRA_INFO. |
| URL_FILE_USE_PATHURL | 65536 | Use DOS path compatibility mode to create "file" Uniform Resource Identifiers (URIs). |
| URL_UNESCAPE_INPLACE | 1048576 | Convert escape sequences back into ordinary characters and overwrites the original string. |
| URL_CONVERT_IF_DOSPATH | 2097152 | Convert to a URL if in a dospath format. |
| URL_UNESCAPE_HIGH_ANSI_ONLY | 4194304 | Unescape only high ANSI escape characters. |
| URL_INTERNAL_PATH | 8388608 | Convert any occurrence of "#" to its escape sequence. |
| URL_BROWSER_MODE | 33554432 | Defined to be the same as URL_DONT_ESCAPE_EXTRA_INFO. |
| URL_DONT_ESCAPE_EXTRA_INFO | 33554432 | 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). This flag should not be used alone or combined with URL_ESCAPE_SEGMENT_ONLY. |
| URL_DONT_UNESCAPE_EXTRA_INFO | 33554432 | 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). This flag should not be used alone or combined with URL_ESCAPE_SEGMENT_ONLY. |
| URL_ESCAPE_SPACES_ONLY | 67108864 | Replace only spaces with escape sequences. This flag takes precedence over URL_ESCAPE_UNSAFE, but does not apply to opaque URLs. |
| URL_DONT_SIMPLIFY | 134217728 | Treat "/./" and "/../" in a URL string as literal characters, not as shorthand for navigation. |
| URL_NO_META | 134217728 | Defined to be the same as URL_DONT_SIMPLIFY. |
| URL_UNESCAPE | 268435456 | Unescape any escape sequences that the URLs contain, with two exceptions. The escape sequences for "?" and "#" are not un-escaped. If one of the URL_ESCAPE flags is also set, the two URLs are first un-escaped, then combined, then escaped. |
| URL_ESCAPE_UNSAFE | 536870912 | Replace unsafe characters with their escape sequences. Unsafe characters are those characters that may be altered during transport across the Internet, and include the <, >, ", #, {, }, |, , ^, [, ], and ' characters. This flag applies to all URLs, including opaque URLs. |
| URL_PLUGGABLE_PROTOCOL | 1073741824 | Combine URLs with client-defined pluggable protocols, according to the World Wide Web Consortium (W3C) specification. This flag does not apply to standard protocols such as ftp, http, gopher, and so on. |
Remarks
This enumeration is used in calls to the unmanaged Windows function UrlCanonicalize. The enumeration values are defined in Shlwapi.h. The flags can be combined.
