IUri::GetAbsoluteUri method

Returns the entire canonicalized Uniform Resource Identifier (URI).

Syntax

HRESULT GetAbsoluteUri(
  [out] BSTR *pbstrAbsoluteUri
);

Parameters

  • pbstrAbsoluteUri [out]
    Address of a BSTR that receives the property value. Caller is responsible for freeing the memory with SysFreeString.

Return value

Returns one of the following values:

Return code Description
S_OK

Success.

S_FALSE

The property is not defined.

E_OUTOFMEMORY

There is insufficient memory to create the BSTR.

 

Remarks

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

This function is for convenience. It is the same as calling IUri::GetPropertyBSTR with the Uri_PROPERTY_ABSOLUTE_URI property.

This property is not defined for relative URIs.

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

Reference

GetDisplayUri

GetRawUri