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

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 3.0

Header

Urlmon.h

IDL

Urlmon.idl

See also

Reference

CoInternetParseUrl

CoInternetParseIUri

ParseUrl