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 code | Description |
|---|---|
| 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 |