Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

IUri::GetAuthority method

Returns the user name, password, domain, and port.

Syntax


HRESULT GetAuthority(
  [out]  BSTR *pbstrAuthority
);

Parameters

pbstrAuthority [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 codeDescription
S_OK

Success.

S_FALSE

The property is not defined.

E_OUTOFMEMORY

There is insufficient memory to create the BSTR.

 

Remarks

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

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

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.

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

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.