NdsDtd_addStatus

Adds a <status> element to the input or output document.

Syntax

C++

 #include "NdsDtd.h"
 
 DIRXML_EXPORT
 NAMESPACE(DOM)Element * NDAPI			 NdsDtd_addStatus(
    NAMESPACE(DOM)Element   *statusParent,
    int                      statusLevel,
    const unicode           *message,
    const unicode           *eventId);

Parameters

statusParent
(IN) Points to the <input> or <output> element to which the <status> element is to be added
statusLevel
(IN) Specifies the status level for the <status> element. The following values are supported:
  • STATUS_LEVEL_FATAL (0)
  • STATUS_LEVEL_ERROR (1)
  • STATUS_LEVEL_WARNING (2)
  • STATUS_LEVEL_SUCCESS (3)
  • STATUS_LEVEL_RETRY (4)
message
(IN) Points to null-terminated message string. It may be set to 0.
eventID
(IN) Points to a null-terminated event ID string. It may be set to 0. For an output document, it should be set to the event ID string sent with the requesting input document.

Remarks

This method returns a pointer to the new <status> element or 0 if an error occurs.

The status element will have the level attribute set based on the statusLevel parameter. It may have an eventId attribute or a text node child with any message passed.