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

 

 

Show: