IHTMLMetaElement::httpEquiv Property

  • Article

Gets or sets information used to bind the value of a IHTMLMetaElement::content attribute of a meta element to an HTTP response header.

Syntax

HRESULT IHTMLMetaElement::get_httpEquiv(BSTR *p);
HRESULT IHTMLMetaElement::put_httpEquiv(BSTR v);

Parameters

  • p
    Pointer to a variable of type BSTR that receives the information in the response header. See HTTP Response Headers for a list of possible values.
  • v
    BSTR that specifies the information in the response header. See HTTP Response Headers for a list of possible values.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

If the property is omitted, the IHTMLMetaElement::name property should be used to identify the meta-information. The IHTMLMetaElement::httpEquiv property is not case-sensitive.

Developers using the httpEquiv and content attributes to refresh documents from alternate URLs should treat the value of content as untrusted data. For more information, please see Security Considerations: Dynamic HTML.

As of Windows Internet Explorer 8, the IHTMLMetaElement::httpEquiv attribute also supports a value of x-ua-compatible, which allows developers to specify the document compatibility mode that Internet Explorer should use to display a webpage. To do this, set the content attribute to a BSTR value containing a comma-delimited list of one or more of the following values.

Value Description
IE=9 The webpage is displayed in IE9 Standards mode.
IE=8 The webpage is displayed in IE8 Standards mode.
IE=7 The webpage is displayed in IE7 Standards mode.
IE=5 The webpage is displayed in IE5 (Quirks) mode.
IE=EmulateIE9 If the webpage specifies a standards-based doctype directive, the page is displayed in IE9 mode; otherwise, it is displayed in IE5 mode.
IE=EmulateIE8 If the webpage specifies a standards-based doctype directive, the page is displayed in IE8 mode; otherwise, it is displayed in IE5 mode.
IE=EmulateIE7 If the webpage specifies a standards-based doctype directive, the page is displayed in IE7 mode; otherwise, it is displayed in IE5 mode.
IE=Edge The webpage is displayed in the highest mode available to the version of Internet Explorer used to view the page. This option is generally intended for testing purposes.

When the content attribute specifies multiple document modes, Internet Explorer displays the page in the highest mode supported by the browser. For more information, see Defining Document Compatibility.

See Also

IHTMLMetaElement::content, meta, Defining Document Compatibility