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 |
|---|---|
|
Success. |
|
The property is not defined. |
|
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 |
|
|
IDL |
|
|
DLL |
|
See also