IHTMLObjectElement::get_name Method

---

Retrieves the name of the control, bookmark, or application.

Syntax

HRESULT get_name(
    BSTR *p 
);

Parameters

p

Address of a string (BSTR) variable that receives the name. For details, see the name property.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The name property is used to bind the value of the control when submitting a form. The name is not the value that is displayed for the button, reset, and submit objects. Submitting the form submits the internally stored value, not the one displayed.

Microsoft® JScript® (compatible with ECMA 262 language specification) allows the name to be changed at run time. This does not change the name in the programming model or in the collection of elements, but does change the name used for submitting elements.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

---

IHTMLObjectElement::put_name Method

---

Sets the name of the control, bookmark, or application.

Syntax

HRESULT put_name(
    BSTR v 
);

Parameters

v

String (BSTR) that specifies the name to set. For details, see the name property.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The name property is used to bind the value of the control when submitting a form. The name is not the value that is displayed for the button, reset, and submit objects. Submitting the form submits the internally stored value, not the one displayed.

Microsoft® JScript® (compatible with ECMA 262 language specification) allows the name to be changed at run time. This does not change the name in the programming model or in the collection of elements, but does change the name used for submitting elements.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0