cpiElementName

Zweck

Ruft den Namen des Zielsyntaxelements ab. Der Name des Syntaxelements wurde zuvor mit cniSetElementName oder cpiSetElementName festgelegt.

Syntax

Ccisize           cpiElementName(
  int*            Rückkehrcode,
  CciElement*            targetElement,
  const CciChar*  Wert,
  CciSize         Länge);

Parameter

Rückkehrcode
Empfängt den Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
Zielelement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
Wert
Gibt die Adresse eines Puffers an, in den der Elementname kopiert wird (Eingabe).
Länge
Die Länge in Buchstaben, angegeben im Parameter Wert (Eingabe).

Rückgabewerte

Wenn erfolgreich, wird der Elementname in den bereitgestellten Puffer kopiert, und die Anzahl an kopierten CciChar Zeichen wird zurückgegeben. Wenn der Puffer für den Elementnamen nicht groß genug ist, wird der Rückkehrcode auf CCI_BUFFER_TOO_SMALL gesetzt, und die Anzahl der erforderlichen Zeichen wird zurückgegeben. Bei allen anderen Fehlern wird CCI_FAILURE zurückgegeben, und der Rückkehrcode gibt den Grund für den Fehler an.

Beispielprogramm

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiElementType
cpiElementValue-Gruppe
cpiElementValueValue
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08430_