Share via

IHTMLMetaElement::name Property

  • Article

Sets or retrieves the value specified in the CONTENT attribute of the meta object.

Syntax

HRESULT IHTMLMetaElement::get_name(BSTR *p);
HRESULT IHTMLMetaElement::put_name(BSTR v);

Parameters

  • p
    Pointer to a variable of type BSTR that receives one of the values listed in Possible Values.
  • v
    BSTR that specifies one of the values listed in Possible Values.

Possible Values

Description Associated CONTENT attribute describes the containing document. Some search engines use this to provide the user with a document summary in the result of a search.
DownloadOptions Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2) and later. Associated CONTENT attribute determines the visibility of buttons in the File Download dialog box.
Note  If more than one META tag is set with the DownloadOptions value, Windows Internet Explorer uses the last one.
Possible values include the following:
noopenHides either the Run or the Open button from the File Download dialog box, depending on which button would normally be displayed.
nosaveHides the Save button from the File Download dialog box.
Generator Associated CONTENT attribute identifies the name of the application used to create the document.
Keywords Associated CONTENT attribute consists of comma-delimited words describing the document. Some search engines use this to allow the user to perform a keyword search.
ProgID Associated CONTENT attribute contains the programmatic identifier of the document's default editor.
Robots Associated CONTENT attribute indicates whether the containing document should be indexed by search engines that recognize the meta object. Possible values include the following:
allSearch engines can index the containing document.
noindexSearch engines cannot index the containing document.
Template Associated CONTENT attribute specifies the location of the template used to edit the document. Use this in conjunction with the ProgID meta object if the editor supports document templates.
name Arbitrary value.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The NAME attribute typically is assigned one of the preceding well-defined values, but any arbitrary value can be specified. Custom tools can be developed to perform special actions on documents containing arbitrary meta tags.

To enable the smart edit features in Internet Explorer 5 or later, add a meta tag to the head of the document. Associate ProgID with the NAME attribute, and associate the programmatic identifier of the desired editor with the CONTENT attribute. If the specified editor is not installed or properly registered on the user's system, the edit button is not displayed. Consult the documentation of your editor to determine its programmatic identifier.