Contains options for URL parsing operations. Used by CoInternetParseUrl, CoInternetParseIUri, and implementations of IInternetProtocolInfo::ParseUrl.
Syntax
typedef enum _tagPARSEACTION { PARSE_CANONICALIZE = 1, PARSE_FRIENDLY, PARSE_SECURITY_URL, PARSE_ROOTDOCUMENT, PARSE_DOCUMENT, PARSE_ANCHOR, PARSE_ENCODE, PARSE_DECODE, PARSE_PATH_FROM_URL, PARSE_URL_FROM_PATH, PARSE_MIME, PARSE_SERVER, PARSE_SCHEMA, PARSE_SITE, PARSE_DOMAIN, PARSE_LOCATION, PARSE_SECURITY_DOMAIN, PARSE_ESCAPE, PARSE_UNESCAPE } PARSEACTION;
Constants
- PARSE_CANONICALIZE
Canonicalize the URL into a standard format. For an example of how HTTP URLs should be formatted, see CreateUri.
- PARSE_FRIENDLY
Retrieve a user-friendly URL for display.
- PARSE_SECURITY_URL
Retrieve the URL that should be used by a security manager to make security decisions. The method should either return a security domain or map the input URL to a known protocol (such as HTTP). See also PARSE_SECURITY_DOMAIN.
- PARSE_ROOTDOCUMENT
Retrieve the scheme and hostname, only.
Windows Internet Explorer 7 and later. CoInternetParseIUri also returns user name, password, and port.
- PARSE_DOCUMENT
Retrieve everything prior to the fragment (named anchor) part of the URL.
- PARSE_ANCHOR
Retrieve the fragment (named anchor), including the delimiting number sign (#).
- PARSE_ENCODE
Unescape the URL. Deprecated in Internet Explorer 8; use PARSE_UNESCAPE instead. To enforce deprecation,
#define URLMON_STRICT.- PARSE_DECODE
Escape the URL. Deprecated in Internet Explorer 8; use PARSE_ESCAPE instead. To enforce deprecation,
#define URLMON_STRICT.- PARSE_PATH_FROM_URL
Retrieve a disk operating system (DOS) file path from a
file://URL.- PARSE_URL_FROM_PATH
Create a
file://URL from the specified DOS file path.- PARSE_MIME
Return the MIME type of this URL based on its file name extension. Not supported by CoInternetParseUrl or CoInternetParseIUri.
- PARSE_SERVER
Return the server name. Not supported by CoInternetParseUrl or CoInternetParseIUri.
- PARSE_SCHEMA
Retrieve the URL scheme for this URL, for example
http.- PARSE_SITE
Retrieve the hostname associated with this URL, for example
www.microsoft.com.- PARSE_DOMAIN
Retrieve the domain associated with this URL.
- PARSE_LOCATION
Same as PARSE_ANCHOR.
- PARSE_SECURITY_DOMAIN
Retrieve the security form of the URL, as
scheme:host.- PARSE_ESCAPE
Percent-encode the URL. Convert reserved characters to escape sequences.
- PARSE_UNESCAPE
Decode a percent-encoded URL. Convert escape sequences to the characters they represent.
Enumerated Type Information
Header and IDL files Urlmon.h, Urlmon.idl Minimum availability Internet Explorer 3.0 Minimum operating systems Windows NT 4.0, Windows 95, Windows CE 2.12
See Also