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_PROPERTY_DISPLAY_URI: Exclude the fragment portion of the URI, if any.
-
Uri_PROPERTY_ABSOLUTE_URI, Uri_PROPERTY_DOMAIN, Uri_PROPERTY_HOST: If the URI is an IDN, always display the hostname encoded as punycode.
-
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 |
|
|
IDL |
|
|
DLL |
|
See also