Manager.URL_CANONFLAGS 枚举

定义

指定如何将 URL 转换为规范格式。Specifies how a URL is converted to canonical form.

此 API 支持产品基础结构,不能在代码中直接使用。

public: enum class Manager::URL_CANONFLAGS
public enum Manager.URL_CANONFLAGS
type Manager.URL_CANONFLAGS = 
Public Enum Manager.URL_CANONFLAGS
继承
Manager.URL_CANONFLAGS

字段

URL_BROWSER_MODE 33554432

定义为与 URL_DONT_ESCAPE_EXTRA_INFO 相同。Defined to be the same as URL_DONT_ESCAPE_EXTRA_INFO.

URL_CONVERT_IF_DOSPATH 2097152

如果采用 dospath 格式,则转换为 URL。Convert to a URL if in a dospath format.

URL_DONT_ESCAPE_EXTRA_INFO 33554432

仅与 URL_ESCAPE_SPACES_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 ? 字符之后的 URL 部分)。character encountered in the string). 此标志不应单独使用,也不应与 URL_ESCAPE_SEGMENT_ONLY 结合使用。This flag should not be used alone or combined with URL_ESCAPE_SEGMENT_ONLY.

URL_DONT_SIMPLIFY 134217728

将 URL 字符串中的“/./”和“/../”视为文本字符,而不是导航的简写。Treat "/./" and "/../" in a URL string as literal characters, not as shorthand for navigation.

URL_DONT_UNESCAPE_EXTRA_INFO 33554432

仅与 URL_ESCAPE_SPACES_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 ? 字符之后的 URL 部分)。character encountered in the string). 此标志不应单独使用,也不应与 URL_ESCAPE_SEGMENT_ONLY 结合使用。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

指示 URL 仅包含服务器组件之后、查询之前的部分。Indication that the URL contains only the section following the server component but preceding the query. 字符串中的所有不安全字符都将被转换。All unsafe characters in the string are converted. 如果在设置此标志时提供了完整的 URL,整个字符串中的所有不安全字符(包括 # 和 ?If a full URL is provided when this flag is set, all unsafe characters in the entire string are converted, including # and ? 字符)都将被转换。characters. 将此标志与 URL_ESCAPE_PERCENT 结合使用,以在转换中包含该字符。Combine this flag with URL_ESCAPE_PERCENT to include that character in the conversion. 此标志不能与 URL_ESCAPE_SPACES_ONLY 或 URL_DONT_ESCAPE_EXTRA_INFO 结合使用。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. 此标志优先于 URL_ESCAPE_UNSAFE,但不适用于非跳转 URL。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. 不安全字符是那些在 Internet 传输过程中可能会更改的字符,包括 <、>、"、#、{、}、|、,、^、[、] 和 ' 字符。Unsafe characters are those characters that may be altered during transport across the Internet, and include the <, >, ", #, {, }, |, , ^, [, ], and ' characters. 此标志适用于所有 URL,包括非跳转 URL。This flag applies to all URLs, including opaque URLs.

URL_FILE_USE_PATHURL 65536

使用 DOS 路径兼容性模式创建“文件”统一资源标识符 (URI)。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

定义为与 URL_DONT_SIMPLIFY 相同。Defined to be the same as URL_DONT_SIMPLIFY.

URL_PLUGGABLE_PROTOCOL 1073741824

根据万维网联合会 (W3C) 规范,将 URL 与客户端定义的可插入协议结合起来。Combine URLs with client-defined pluggable protocols, according to the World Wide Web Consortium (W3C) specification. 此标志不适用于 FTP、HTTP 和 Gopher 等标准协议。This flag does not apply to standard protocols such as ftp, http, gopher, and so on.

URL_UNESCAPE 268435456

对 URL 包含的任何转义序列进行转回,但有两个转义序列例外。Unescape any escape sequences that the URLs contain, with two exceptions. 未对“?”和“#”的转义序列进行转回操作。The escape sequences for "?" and "#" are not un-escaped. 如果还设置了其中某种 URL_ESCAPE 标志,那么对两个 URL 依次执行的操作是:转回、合并和转义。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

仅对高 ANSI 转义字符进行转回操作。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

合并所有参数,以创建完整的 URL。Merge all the parameters to create a full URL.

注解

此枚举用于对非托管 Windows 函数 UrlCanonicalize 的调用。This enumeration is used in calls to the unmanaged Windows function UrlCanonicalize. 枚举值是在 Shlwapi 中定义的。The enumeration values are defined in Shlwapi.h. 可以组合这些标志。The flags can be combined.

适用于