Export (0) Print
Expand All

Manager.URL_CANONFLAGS Enumeration

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Specifies how a URL is converted to canonical form.

Namespace:  Microsoft.IE
Assembly:  IEHost (in IEHost.dll)

public enum URL_CANONFLAGS

Member nameDescription
URL_UNESCAPEUnescape any escape sequences that the URLs contain, with two exceptions. The escape sequences for ? and # characters are not unescaped. If one of the URL_ESCAPE flags is also set, the two URLs are unescaped, combined, and then escaped.
URL_ESCAPE_UNSAFEReplace unsafe characters with their escape sequences. Unsafe characters are 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_PROTOCOLCombine 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_WININET_COMPATIBILITYMerge all the parameters to create a full URL
URL_DONT_ESCAPE_EXTRA_INFOUsed 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_INFOUsed 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_BROWSER_MODEDefined to be the same as URL_DONT_ESCAPE_EXTRA_INFO.
URL_ESCAPE_SPACES_ONLYReplace only spaces with escape sequences. This flag takes precedence over URL_ESCAPE_UNSAFE, but does not apply to opaque URLs.
URL_DONT_SIMPLIFYTreat /./ and /../ in a URL string as literal characters, and not as shorthand for navigation.
URL_NO_METADefined to be the same as URL_DONT_SIMPLIFY.
URL_UNESCAPE_INPLACEConvert escape sequences back into ordinary characters and overwrite the original string.
URL_CONVERT_IF_DOSPATHConvert to a URL if in a dospath format.
URL_UNESCAPE_HIGH_ANSI_ONLYUnescape only high ANSI escape characters.
URL_INTERNAL_PATHEscape # characters found in paths.
URL_FILE_USE_PATHURLUse DOS path compatibility mode to create "file" Uniform Resource Identifiers (URIs).
URL_ESCAPE_PERCENTConvert any occurrence of "%" to its escape sequence.
URL_ESCAPE_SEGMENT_ONLYIndication 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.

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.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft