cniFirstChild

Diese Funktion gibt die Adresse des Syntaxelementobjekts zurück, das das erste untergeordnete Element des angegebenen Syntaxelements ist.

Syntax

CciElement* cniFirstChild(
  int*         returnCode,
  CciElement*  targetElement);

Parameter

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

Rückgabewerte

  • Bei erfolgreicher Ausführung wird die Adresse des angeforderten Syntaxelementobjekts zurückgegeben.
  • Wenn kein erstes untergeordnetes Element vorhanden ist, wird der Wert null zurückgegeben, und als Wert für returnCode wird CCI_SUCCESS festgelegt.
  • Wenn ein Fehler auftritt, wird der Wert null (CCI_NULL_ADDR) zurückgegeben, und der Parameter returnCode gibt die Fehlerursache an.

Beispiel

  if (element != 0) {
    cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));
    firstChild = cniFirstChild(&rc, element);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07720_