cniElementName

Diese Funktion ruft den Wert des Attributs name für das angegebene Syntaxelement ab. Der Name des Syntaxelements wurde zuvor mit cniSetElementName oder cpiSetElementName festgelegt.

Syntax

CciSize cniElementName(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  value,
  Ccisize         length);

Parameter

returnCode
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
targetElement
Die Adresse des Zielsyntaxelementobjekts (Eingabe).
value
Die Adresse eines Puffers, in den der Elementname kopiert wird (Eingabe).
length
Die Länge (in Zeichen) des Puffers, der im Parameter value angegeben wird (Eingabe).

Rückgabewerte

  • Bei erfolgreicher Ausführung wird der Elementname in den angegebenen Puffer kopiert, und die Anzahl der kopierten Zeichen des Typs CciChar wird zurückgegeben.
  • Wenn der Puffer für den Attributwert nicht groß genug ist, wird als Wert für returnCode CCI_BUFFER_TOO_SMALL festgelegt, und die erforderliche Anzahl der Zeichen (CciChars) wird zurückgegeben.
  • Bei anderen Fehlern wird CCI_FAILURE zurückgegeben, und returnCode gibt die Fehlerursache an.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07890_