IUri::GetDomain method

2016-07-13

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

Dela via