cpiSetNameFromBuffer

Diese Funktion legt das Namensattribut des Zielsyntaxelements fest, indem die im Puffer gelieferten Daten verwendet werden, auf die der Parameter name zeigt. Die Größe des Namens wird mithilfe des Parameters Länge angegeben.

Syntax

void cpiSetNameFromBuffer(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  name,
  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
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
name
Die Adresse eines Puffers, der den Namen enthält (Eingabe).
length
Die Länge der durch den Namensparameter angegebenen Zeichenfolge, dargestellt als Anzahl von CciChar-Zeichen.

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt returnCode den Grund für den Fehler an.

Mustercode

/* Konvertieren Sie den Attributwert ins Brokerformat */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Erstellen Sie ein neues Namenswertelement für das Attribut */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetNameFromBuffer(&rc, newElement, data, length);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMEVALUE element; 
                    object=0x%x type=0x%x name=",
                    newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
            fprintf(pc->tracefile, "%s\n", mbData);
            fflush(pc->tracefile);
            free((void *)mbData);
          }
          /* Geben Sie den in 'CciNString()' erstellten Speicherplatz frei */
          free((void *)data);

          /* Fügen Sie das Element hinzu */
          cpiAddAsLastChild(&rc, element, newElement);
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

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


ReferenzthemaReferenzthema | Version 8.0.0.1 | as08540_