cniFirstChild

Verwenden Sie diese Funktion, um die Adresse des Syntaxelementobjekts abzurufen, das das erste untergeordnete Element des angegebenen Syntaxelements ist.

Syntax

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

Parameter

returnCode
Der Rückkehrcode von 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 Erfolg wird die Adresse des angeforderten Syntaxelementobjekts zurückgegeben.
  • Fall kein erstes untergeordnetes Element vorhanden ist, wird null ausgegeben, und returnCode wird auf CCI_SUCCESS gesetzt.
  • Beim Auftreten eines Fehlers wird null (CCI_NULL_ADDR) ausgegeben, und der Parameter returnCode gibt den Grund für den Fehler an.

Beispiel

  if (element != 0) {
    cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));
    firstChild = cniFirstChild(&rc, element);
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-07-16 12:21:29


ReferenzthemaReferenzthema | Version 8.0.0.1 | as07720_