cniRootElement

Ruft das Stammsyntaxelement auf, das mit einer angegebenen Nachricht verknüpft ist. Es gibt das Stammelement zurück, das mit dem Nachrichtenobjekt verknüpft ist (das auch der Eigner ist), welches durch den Parameter message identifiziert wird. Wenn ein Nachrichtenobjekt vom Broker erstellt wird, wird automatisch ein Stammelement erzeugt.

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 Erfolg wird die Adresse des Stammelementobjekts zurückgegeben. Ansonsten wird Null (CCI_NULL_ADDR) ausgegeben, und der Parameter returnCode gibt den Grund für den Fehler an.

Beispiel

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