Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Manager.URL_CANONFLAGS Enumeration

This enumeration 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
public enum URL_CANONFLAGS
public enum URL_CANONFLAGS

 Member nameDescription
URL_BROWSER_MODEDefined to be the same as URL_DONT_ESCAPE_EXTRA_INFO
URL_CONVERT_IF_DOSPATHConvert to a URL if in a dospath format. 
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_SIMPLIFYTreat /./ and /../ in a URL string as literal characters, and not as shorthand for navigation. 
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_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.

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_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_FILE_USE_PATHURLUse DOS path compatibility mode to create "file" Uniform Resource Identifiers (URIs). 
URL_INTERNAL_PATHEscape # characters found in paths. 
URL_NO_METADefined to be the same as URL_DONT_SIMPLIFY
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_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_UNESCAPE_HIGH_ANSI_ONLYUnescape only high ANSI escape characters. 
URL_UNESCAPE_INPLACEConvert escape sequences back into ordinary characters and overwrite the original string. 
URL_WININET_COMPATIBILITYMerge all the parameters to create a full URL 

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 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft