cniRootElement

Diese Funktion ruft das Stammsyntaxelement ab, das einer angegebenen Nachricht zugeordnet ist. Sie gibt das Stammelement zurück, das dem Nachrichtobjekt, das durch den Parameter message angegeben wird, zugeordnet ist (und ihm gehört). Wenn ein Nachrichtenobjekt vom Broker erstellt wird, wird automatisch ein Stammelement erstellt.

Syntax

CciElement* cniRootElement(
  int*         returnCode,
  CciMessage*  message);

Parameter

returnCode
Der Rückkehrcode aus der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
Die Adresse des Nachrichtenobjekts (Eingabe).

Rückgabewerte

Bei erfolgreicher Ausführung wird die Adresse des Stammelements zurückgegeben. Andernfalls wird der Wert null (CCI_NULL_ADDR) zurückgegeben, und der Parameter returnCode gibt die Fehlerursache an.

Beispiel

   inRootElement = cniRootElement(&rc, message);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07680_