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

See also

IUri