cpiElementName

Diese Funktion ruft den Namen des Zielsyntaxelements ab. Der Name des Syntaxelements muss zuvor mit cniSetElementName oder cpiSetElementName festgelegt werden.

Syntax

Ccisize           cpiElementName(
  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
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
value
Gibt die Adresse eines Puffers an, 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 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 returnCode gibt den Grund für den Fehler an.

Mustercode

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-02-27 15:22:30


ReferenzthemaReferenzthema | Version 8.0.0.2 | as08430_