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