PARSEACTION enumeration

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.

  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 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.

Requirements

See also

Reference

CoInternetParseUrl

CoInternetParseIUri

ParseUrl