IUri::GetDomain method
Returns the domain name (including top-level domain) only.
Syntax
HRESULT GetDomain(
[out] BSTR *pbstrDomain
);
Parameters
- pbstrDomain [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::GetDomain was introduced in Windows Internet Explorer 7.
This function is for convenience. It is the same as calling IUri::GetPropertyBSTR with the Uri_PROPERTY_DOMAIN property.
If the URL contains only a plain hostname (for example, "http://example/") or a public suffix (for example, "http://co.uk/"), then IUri::GetDomain returns NULL. Use IUri::GetHost instead.
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 |