Compartilhar via


Uri_PROPERTY enumeration

Represents properties that an IUri can contain. The properties in the range Uri_PROPERTY_STRING_START to Uri_PROPERTY_STRING_LAST are strings and the rest are DWORD values.

Syntax

typedef enum  { 
  Uri_PROPERTY_ABSOLUTE_URI    = 0,
  Uri_PROPERTY_STRING_START    = Uri_PROPERTY_ABSOLUTE_URI,
  Uri_PROPERTY_AUTHORITY       = 1,
  Uri_PROPERTY_DISPLAY_URI     = 2,
  Uri_PROPERTY_DOMAIN          = 3,
  Uri_PROPERTY_EXTENSION       = 4,
  Uri_PROPERTY_FRAGMENT        = 5,
  Uri_PROPERTY_HOST            = 6,
  Uri_PROPERTY_PASSWORD        = 7,
  Uri_PROPERTY_PATH            = 8,
  Uri_PROPERTY_PATH_AND_QUERY  = 9,
  Uri_PROPERTY_QUERY           = 10,
  Uri_PROPERTY_RAW_URI         = 11,
  Uri_PROPERTY_SCHEME_NAME     = 12,
  Uri_PROPERTY_USER_INFO       = 13,
  Uri_PROPERTY_USER_NAME       = 14,
  Uri_PROPERTY_STRING_LAST     = Uri_PROPERTY_USER_NAME,
  Uri_PROPERTY_HOST_TYPE       = 15,
  Uri_PROPERTY_DWORD_START     = Uri_PROPERTY_HOST_TYPE,
  Uri_PROPERTY_PORT            = 16,
  Uri_PROPERTY_SCHEME          = 17,
  Uri_PROPERTY_ZONE            = 18,
  Uri_PROPERTY_DWORD_LAST      = Uri_PROPERTY_ZONE
} Uri_PROPERTY;

Constants

  • Uri_PROPERTY_ABSOLUTE_URI
    Includes the entire canonicalized URI. This property is not defined for relative URLs. See also Uri_PROPERTY_RAW_URI.

    ftp://username:password@hostname.domain.com:8080/path/file.ext?query#fragment
    
  • Uri_PROPERTY_STRING_START
    Designates the first string property.

  • Uri_PROPERTY_AUTHORITY
    Combines user name, password, fully qualified domain name, and port number. If user name and password are not specified, the separator characters (: and @) are removed. The trailing colon is also removed if the port number is not specified or is the default for the protocol scheme.

    username:password@hostname.domain.com:8080
    
  • Uri_PROPERTY_DISPLAY_URI
    Combines protocol scheme, fully qualified domain name, port number, full path, query string, and (optionally) fragment. (Pass the Uri_DISPLAY_NO_FRAGMENT flag to get one or more of the following methods to hide the fragment portion: IUri::GetPropertyBSTR and IUri::GetPropertyLength.) If the scheme is unrecognized, the user name and password will also be displayed.

    ftp://hostname.domain.com:8080/path/file.ext?query#fragment
    

    Note   The display URI may have additional formatting applied to it, such that the string produced by IUri::GetDisplayUri isn't necessarily a valid URI. For this reason, and since the userinfo is not present, the display URI should be used for viewing only; it should not be used for edit by the user, or as a form of transfer for URIs inside or between applications.

     

  • Uri_PROPERTY_DOMAIN
    Indicates the private domain name and public suffix (top-level domain) only. If the URL contains only a plain hostname (for example, "http://example/") or public suffix (for example, "http://co.uk/"), then Uri_PROPERTY_DOMAIN is NULL; use Uri_PROPERTY_HOST instead.

    domain.com
    
  • Uri_PROPERTY_EXTENSION
    Indicates the file name extension only.

    .ext
    
  • Uri_PROPERTY_FRAGMENT
    Indicates the fragment (secondary resource, or named anchor identifier) only.

    #fragment
    
  • Uri_PROPERTY_HOST
    Indicates the fully qualified domain name or plain hostname. See also Uri_PROPERTY_DOMAIN.

    hostname.domain.com
    
  • Uri_PROPERTY_PASSWORD
    Indicates the password only, as parsed from the URI. Prompted credentials do not appear here.

    password
    

Security Warning: Storing sensitive information as clear text in a URI is not recommended. According to RFC3986: Uniform Resource Identifier (URI), Generic Syntax, Section 7.5, "A password appearing within the userinfo component is deprecated and should be considered an error except in those rare cases where the 'password' parameter is intended to be public."

  • Uri_PROPERTY_PATH
    Indicates the path and resource.

    /path/file.ext
    
  • Uri_PROPERTY_PATH_AND_QUERY
    Combines full path to resource with URI query string.

    /path/file.ext?query
    
  • Uri_PROPERTY_QUERY
    Indicates the query (or search) string. The search string may be canonicalized by CreateUri if the Uri_CREATE_DECODE_EXTRA flag was used; however, no other encoding or decoding is performed.

    ?query
    
  • Uri_PROPERTY_RAW_URI
    Includes the entire original URI as entered. Note that character %61 is lowercase A in the following example. See also Uri_PROPERTY_ABSOLUTE_URI.

    ftp://username:password@hostn%61me.domain.com:8080/path/file.ext?query#fragment
    
  • Uri_PROPERTY_SCHEME_NAME
    Indicates the protocol scheme name. See also Uri_PROPERTY_SCHEME.

    ftp
    
  • Uri_PROPERTY_USER_INFO
    Combines user name and password as parsed from the URI. String does not include colon (:) if password is not present.

    username:password
    
  • Uri_PROPERTY_USER_NAME
    Indicates the user name only, as parsed from the URI. Prompted credentials do not appear here.

    username
    
  • Uri_PROPERTY_STRING_LAST
    Designates the final string property.

  • Uri_PROPERTY_HOST_TYPE
    Returns a value from the Uri_HOST_TYPE enumeration.

  • Uri_PROPERTY_DWORD_START
    Designates the first numerical property.

  • Uri_PROPERTY_PORT
    Indicates the port number only.

    8080
    
  • Uri_PROPERTY_SCHEME
    Returns a value from the URL_SCHEME enumeration. See also Uri_PROPERTY_SCHEME_NAME.

  • Uri_PROPERTY_ZONE
    Not implemented. To calculate the zone of a URI object, pass the URI to the IInternetSecurityManagerEx2::MapUrlToZoneEx2 method.

  • Uri_PROPERTY_DWORD_LAST
    Designates the final numerical property.

Requirements

Minimum supported client

Windows XP with SP2

Minimum supported server

Windows Server 2003 with SP1

Product

Internet Explorer 7

Header

Urlmon.h

IDL

Urlmon.idl

See also

Reference

CreateUri

GetPropertyBSTR

GetPropertyDWORD

GetPropertyLength

HasProperty