IHTMLDocument2::get_domain Method

Retrieves or the security domain of the document.

Syntax

HRESULT get_domain(
    BSTR *p
);

Parameters

p
Address of a string variable that receives the security domain.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The domain property initially returns the hostname of the server that the page is from. This property can be assigned the domain suffix to allow sharing of pages across frames. For example, a page in one frame from home.microsoft.com and a page from www.microsoft.com would initially not be able to communicate with each other. However, by setting the domain property of both pages to the suffix, microsoft.com, both pages would be considered secure and now code can access between the pages.

IHTMLDocument2::put_domain Method

Sets or returns the security domain of the document.

Syntax

HRESULT put_domain(
    BSTR v
);

Parameters

v
String specifying the security domain.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The domain property initially returns the host name of the server the page is from. This property can be assigned the domain suffix to allow sharing of pages across frames. For example, a page in one frame from home.microsoft.com and a page from www.microsoft.com would initially not be able to communicate with each other. However, by setting the domain property of both pages to the suffix, microsoft.com, both pages would be considered secure and now code can be shared between the pages.