cniElementName

Ruft den Wert des Attributs name für das angegebene Syntaxelement ab. Der Name des Syntaxelements wurde zuvor mit Hilfe von cniSetElementName oder cpiSetElementName festgelegt.

Syntax

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

Parameter

returnCode
Der 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), die vom Parameter value angegeben wird (Eingabe).

Rückgabewerte

  • Bei Erfolg wird der Elementname in den bereitgestellten Puffer kopiert und die Zahl der kopierten CciChar-Zeichen ausgegeben.
  • 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 jeglichen anderen Fehlern wird CCI_FAILURE ausgegeben, und returnCode gibt den Grund dafür an.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07890_