2.173 .ixmldomdocument2

The IXMLDOMDocument2 COM interface pointer of the XML Document can be accessed through this attribute under Microsoft Windows. When a new value is set in the XML Document, the saved DOM tree will be deleted. All existing XML Cursors will become invalid. The attribute .mapped has the value false by invalid XML Cursors.

Definition

  • Data type

    pointer

  • Access

    get, set

  • changed event

    no

  • C

    Identifier: AT_ixmldomdocument2

    Data type: DT_pointer

  • COBOL

    Identifier: AT-ixmldomdocument2

    Data type: DT-pointer

  • Inheritance

    no

  • Classification

    object-specific attribute

  • Objects

    document

In the Rule Language the attribute can only be assigned to the same attribute of a different Dialog Manager object. Be aware, that in the programming interface the COM object is only valid during the time when it is in use by the Dialog Manager. Therefore, an application should increase its reference counter (COM Method: IUnknown->AddRef). When the object is no longer needed, the counter should be set back again, or decreased (COM Method: IUnknown->Release). Please note, the counter cannot be decreased more often than it is increased. Otherwise, the COM object will be released. The Dialog Manager cannot recognize this situation and this will lead to a system crash. The Dialog Manager will also crash if the given pointer does not point to a COM interface. The attribute is available for the XML Document, but it cannot be passed down.