SetParentObject

Description

Sets the referenced PBDOM_OBJECT to be the parent of the current PBDOM_PROCESSINGINSTRUCTION object.

Syntax

pbdom_pi_name.SetParentObject(pbdom_object pbdom_object_ref)

Argument

Description

pbdom_pi_name

The name of a PBDOM_PROCESSINGINSTRUCTION object

pbdom_object_ref

A PBDOM_OBJECT to be set as the parent of the current PBDOM_PROCESSINGINSTRUCTION object


Return value

PBDOM_OBJECT. This PBDOM_PROCESSINGINSTRUCTION object modified.

Throws

EXCEPTION_PBDOM_OBJECT_INVALID_FOR_USE -- If the input PBDOM_OBJECT is not a reference to an object derived from PBDOM_OBJECT.

EXCEPTION_HIERARCHY_ERROR -- If setting the input PBDOM_OBJECT to be the parent of this PBDOM_PROCESSINGINSTRUCTION object will cause the parent PBDOM_OBJECT to be no longer well formed. For example, if this PBDOM_PROCESSINGINSTRUCTION object is an XML declaration and the parent to be set is a PBDOM_ELEMENT.

Usage

The PBDOM_OBJECT that you set as the parent and the current PBDOM_PROCESSINGINSTRUCTION object must have a legal parent-child relationship. Currently, only a PBDOM_ELEMENT and a PBDOM_DOCUMENT can be set as the parent of a PBDOM_PROCESSINGINSTRUCTION object.