cciGetNodeName

Diese Funktion gibt den Namen des angegebenen Knotens zurück.

Syntax

CciSize getNodeName (int* returnCode,
                                        CciNode* node,
                                        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 Knotennamens.

node (Eingabe)
Dies ist eine interne Kennung für einen Knoten.
value (Ausgabe)
Die Adresse eines Puffers, der vom aufrufenden Modul für die Speicherung des Knotennamenswerts zugeordnet wird.
length
Die Länge (in CciChar) des Puffers, der vom aufrufenden Modul zugeordnet wird.

Rückgabewerte

  • Bei erfolgreicher Ausführung wird der Knotenname in den angegebenen Puffer kopiert, und die Anzahl der kopierten Zeichen des Typs CciChar wird zurückgegeben.
  • Wenn der Puffer für den Knotennamen 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.

Beispiel

void myPropagatedMessageCallback(
                        CciMessage*        message,
                        CciMessage* localEnvironment,
                        CciMessage* exceptionList,          
                        CciMessage* environment,
                        CciConnection* connection){
 
	int rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(&rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(&rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*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*/
}  
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
as35990_