Manager.URL_CANONFLAGS Enum

Definition

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_CANONFLAGS
public enum Manager.URL_CANONFLAGS
type Manager.URL_CANONFLAGS = 
Public Enum Manager.URL_CANONFLAGS
Inheritance
Manager.URL_CANONFLAGS

Fields

URL_BROWSER_MODE 33554432

Defined to be the same as URL_DONT_ESCAPE_EXTRA_INFO.

URL_CONVERT_IF_DOSPATH 2097152

Convert to a URL if in a dospath format.

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_SIMPLIFY 134217728

Treat "/./" and "/../" in a URL string as literal characters, not as shorthand for navigation.

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_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_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_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_FILE_USE_PATHURL 65536

Use DOS path compatibility mode to create "file" Uniform Resource Identifiers (URIs).

URL_INTERNAL_PATH 8388608

Convert any occurrence of "#" to its escape sequence.

URL_NO_META 134217728

Defined to be the same as URL_DONT_SIMPLIFY.

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.

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_UNESCAPE_HIGH_ANSI_ONLY 4194304

Unescape only high ANSI escape characters.

URL_UNESCAPE_INPLACE 1048576

Convert escape sequences back into ordinary characters and overwrites the original string.

URL_WININET_COMPATIBILITY -2147483648

Merge all the parameters to create a full URL.

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.

Applies to