Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |