cciGetNodeAttribute

Diese Funktion gibt den Wert des angegebenen Attributs zurück.

Syntax

CciSize cciGetNodeAttribute (int* returnCode,
                         CciNode* node,
                         CciChar*    name,
                         CciChar* value,
                         CciSize         length);

Parameter

returnCode (Ausgabe)
Empfängt den Rückkehrcode von der Funktion (Ausgabe).
  • CCI_INV_BUFFER_TOO_SMALL

    Der bereitgestellte Puffer war nicht groß genug für den Wert des Knotentyps.

node (Eingabe)
Dies ist eine interne Kennung für einen Knoten.
name (Eingabe)
Dies ist ein Zeiger auf eine auf NULL endende Zeichenfolge des Typs 'CciChar', der den Namen des abgefragten Knotenattributs angibt.
value (Ausgabe)
Die Adresse eines Puffers, der vom aufrufenden Modul für die Speicherung des Attributwerts zugeordnet wird.
length
Die Länge (in CciChar) des Puffers, der vom aufrufenden Modul zugeordnet wird.

Rückgabewerte

  • Bei erfolgreicher Ausführung wird der Attributwert 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.
  • Wenn name einen Attributnamen angibt, der für den angegebenen Knoten nicht geeignet ist, wird returnCode auf CCI_ATTRIBUTE_UNKOWN gesetzt.

Beispiel

void myPropagatedMessageCallback(
                        CciMessage*        message,
                        CciMessage* localEnvironment,
                        CciMessage* exceptionList,          
                        CciMessage* environment,
                        CciConnection* connection){
 	int rc = CCI_SUCCESS;
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /*Sie sollten jetzt den RC auf unerwartete Werte prüfen*/
   CciChar queueNameAttribute[16];
   cciMbsToUcs(&rc,
               "queueName",
               queueNameAttribute,
               16,
               BIP_DEF_COMP_CCSID);
 /*Sie sollten jetzt den RC auf unerwartete Werte prüfen*/

   CciChar queueName [512];
   sourceNodeQueueNameLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         queueName,
                                         512);
   /*Sie sollten jetzt den RC auf unerwartete Werte prüfen*/
   /*Wenn der RC CCI_BUFFER_TOO_SMALL ist, sollten Sie die Größe ändern und den Versuch wiederholen*/ /*sourceNodeQueueNameLength enthält die tatsächliche oder erforderliche Größe */
Zugehörige Konzepte
Benutzerexits entwickeln
Zugehörige Tasks
Benutzerexit entwickeln
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as36010_