Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IUri::GetPropertyLength method

Returns the string length of the specified Uniform Resource Identifier (URI) property. Call this function if you want the length but don't necessarily want to create a new BSTR.

Syntax


HRESULT GetPropertyLength(
  [in]  Uri_PROPERTY uriProp,
  [out] DWORD        *pcchProperty,
  [in]  DWORD        dwFlags
);

Parameters

uriProp [in]

A value from the Uri_PROPERTY enumeration.

pcchProperty [out]

Address of a DWORD that is set to the length of the value of the string property excluding the NULL terminator.

dwFlags [in]

One of the following property-specific flags, or zero.

Uri_DISPLAY_NO_FRAGMENT (0x00000001)

Uri_PROPERTY_DISPLAY_URI: Exclude the fragment portion of the URI, if any.

Uri_PUNYCODE_IDN_HOST (0x00000002)

Uri_PROPERTY_ABSOLUTE_URI, Uri_PROPERTY_DOMAIN, Uri_PROPERTY_HOST: If the URI is an IDN, always display the hostname encoded as punycode.

Uri_DISPLAY_IDN_HOST (0x00000004)

Uri_PROPERTY_ABSOLUTE_URI, Uri_PROPERTY_DOMAIN, Uri_PROPERTY_HOST: Display the hostname in punycode or Unicode as it would appear in the Uri_PROPERTY_DISPLAY_URI property.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

IUri::GetPropertyLength was introduced in Windows Internet Explorer 7.

The uriProp parameter must be a string property. This method will fail if the specified property isn't a BSTR property.

This method will return S_FALSE and set pcchProperty to 0 if the URI doesn't contain the specified 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

DLL

Urlmon.dll

See also

IUri
IUri::GetPropertyBSTR

 

 

Show:
© 2016 Microsoft