cciGetNodeAttribute

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

Syntax

CciSize  cciGetNodeAttribute (int*           returnCode,
                         CciNode*       node,
                         CciChar*    Name,
                         CciChar*       value,
                         CciSize         Länge);

Parameter

Rückkehrcode (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 Kennung für einen Knoten.
name (Eingabe)
Dies ist ein Zeiger auf eine auf NULL endende Zeichenfolge von 'CciChar' unter Angabe des Namens des abgefragten Knotenattributs.
value (Ausgabe)
Adresse eines Puffers, der vom Aufrufenden für den Wert des Attributs reserviert wurde.
Länge
Die Länge (in 'CciChars') des Puffers, der vom Aufrufenden reserviert wurde.

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 nicht zum gegebenen Knoten passt, 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);
   /*rc sollte nun auf unerwartete Werte überprüft werden*/
   CciChar   queueNameAttribute[16];
   cciMbsToUcs(&rc,
               "queueName",
               queueNameAttribute,
               16,
               BIP_DEF_COMP_CCSID);
 /*rc sollte nun auf unerwartete Werte überprüft werden*/

   CciChar queueName [512];
   sourceNodeQueueNameLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         queueName,
                                         512);
   /*rc sollte nun auf unerwartete Werte überprüft werden*/
   /*wenn rc 'CCI_BUFFER_TOO_SMALL' ist, sollten Sie die Größe ändern und es erneut versuchen*/
 /*'sourceNodeQueueNameLength' wird die aktuelle oder erforderliche Größe halten */
Zugehörige Konzepte
Benutzerexits
Zugehörige Tasks
Benutzerexit entwickeln
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:30:04

as36010_