Contents Index Topic Contents
	Previous Topic: IHTMLObjectElement::put_name Next Topic: IHTMLObjectElement::put_codeBase

IHTMLObjectElement::get_name

HRESULT get_name(
    BSTR *p 
);

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

• Returns S_OK if successful, or an error value otherwise.

p

Address of a variable that receives the name.

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 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.

See also put_name

 Top of Page

---

IHTMLObjectElement::put_name

HRESULT put_name(
    BSTR v 
);

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

• Returns S_OK if successful, or an error value otherwise.

v

String specifying the name.

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 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.

See also get_name

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.