domain property

  • Article

Sets or gets the security domain of the document.

Syntax

HRESULT value = object.put_domain( v);HRESULT value = object.get_domain(* p);

Property values

Type: BSTR

the domain suffix.

Standards information

Remarks

The property initially returns the host name of the server from which the page is served. The 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 initially cannot communicate with each other. However, by setting the IHTMLDocument2::domain property of both pages to the suffix "microsoft.com," you ensure that both pages are considered secure and access is available between the pages.

When you set the IHTMLDocument2::domain property, use the domain name determined by the server instead of the domain name determined by the client.

All the pages on different hosts must have the IHTMLDocument2::domain property explicitly set to the same value to communicate successfully with each other. For example, the value of the IHTMLDocument2::domain property of a page on the host microsoft.com is "microsoft.com" by default. It might seem logical that if you set the IHTMLDocument2::domain property of a page on another host named msdn.microsoft.com to "microsoft.com," that the two pages could communicate with each other. However, this is not the case, unless you explicitly set the IHTMLDocument2::domain property of the page on microsoft.com to "microsoft.com."

This property cannot be used to enable cross-frame communication among frames with different domain suffixes. For example, a page in one frame from www.microsoft.com and a page in another frame from www.msn.com cannot communicate with each other, even if the IHTMLDocument2::domain property of both pages is set to the suffix "microsoft.com."

Security Warning: If you use this property incorrectly, you can compromise the security of your Web site. Set the IHTMLDocument2::domain property only if you must allow cross-domain scripting. Use a value determined on the server. If you set this property to a value determined on the client, such as through the location object, you might expose your site to attack from another site through Domain Name System (DNS) manipulation. For more information, see Security Considerations: Hosting and Reuse.

Security Warning: If you use this property incorrectly, you can compromise the security of your Web site. Set the IHTMLDocument2::domain property only if you must allow cross-domain scripting. Use a value determined on the server. If you set this property to a value determined on the client, such as through the location object, you might expose your site to attack from another site through DNS manipulation. For more information, see Security Considerations: Dynamic HTML.

For more information on domain security, see About Cross-Frame Scripting and Security.