Contents Index Topic Contents
	Previous Topic: IHTMLFrameSetElement::put_name Next Topic: IHTMLFrameSetElement::put_onload

IHTMLFrameSetElement::get_name

HRESULT get_name(
    BSTR *p
);

Retrieves the name of the frame so it can be targeted from links in other documents.

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

p

Address of a variable that receives the window or frame name, or one of these values:

window_name	String that specifies a frame.
_blank	Loads the link into a new, unnamed window.
_parent	Loads the link over the parent. If the frame has no parent, this refers to _self.
_self	Replaces the page with the specified link.
_top	Loads the link at the topmost level.

The name property on the window comes from the FRAME definition. There is no other way to persist a window name in HTML.

See also put_name

 Top of Page

---

IHTMLFrameSetElement::put_name

HRESULT put_name(
    BSTR v
);

Sets the name of the frame so it can be targeted from links in other documents.

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

v

String specifying the name. It can be the name of a window or frame, or one of the following values:

window_name	String that specifies a frame.
_blank	Loads the link into a new, unnamed window.
_parent	Loads the link over the parent. If the frame has no parent, this refers to _self.
_self	Replaces the page with the specified link.
_top	Loads the link at the topmost level.

The name property on the window comes from the FRAME definition. There is no other way to persist a window name in HTML.

See also get_name

---

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