IHTMLFormElement::get_name Method

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

Syntax

HRESULT get_name(
    BSTR *p
);

Parameters

p
Address of a variable that receives the name.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The name 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.
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, in the collection of elements, but does change the name used for submitting elements.

IHTMLFormElement::put_name Method

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

Syntax

HRESULT put_name(
    BSTR v
);

Parameters

v
String specifying the name.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The name 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.
JScript™ (compatible with ECMA 262 language specification) allows the name to be changed at run time. This does change the name in the programming model, in the collection of elements, but does change the name used for submitting elements.