IHTMLFormElement::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) 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 displayed for the button, reset, and submit objects. Submitting the form submits the internally stored value, not the one displayed.

Changing the name at run time alters the name only for the name/value pairs sent to the server. The name of the element used by the elements collection does not change.

Windows CE

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

---

IHTMLFormElement::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 displayed for the button, reset, and submit objects. Submitting the form submits the internally stored value, not the one displayed.

Changing the name at run time alters the name only for the name/value pairs sent to the server. The name of the element used by the elements collection does not change.

Windows CE

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