cciGetTargetTerminalName

Questa funzione restituisce il nome del terminale di input del nodo di destinazione per la connessione specificata.

Sintassi

CciSize  cciGetTargetTerminalName (int*           returnCode,
                                   CciConnection* connection,
                                   CciChar*       value,
                                   CciSize        length);

Parametri

returnCode (output)
Riceve il codice di ritorno dalla funzione (output).
  • CCI_BUFFER_TOO_SMALL

    Il buffer fornito non era sufficientemente capiente per contenere il valore del nome nodo.

connection (input)
Questo è un handle a una connessione tra due nodi.
value (output)
Indirizzo di un buffer, assegnato dal chiamante per conservare il valore del nome del terminale.
length
La lunghezza, in CciChars, del buffer assegnato dal chiamante.

Valori di restituzione

  • Se ha esito positivo, il nome terminale viene copiato nel buffer fornito e viene restituito il numero di caratteri CciChar copiati.
  • Se il buffer non è grande a sufficienza per contenere il nome terminale, returnCode è impostato su CCI_BUFFER_TOO_SMALL e viene restituito il numero di CciChars richiesti.

Esempio

void myPropagatedMessageCallback(
                        CciDataContext* userContext,
                        CciMessage*  message,
                        CciMessage*    localEnvironment,
                        CciMessage*  exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
   	int rc = CCI_SUCCESS;
   CciChar targetTerminalName[initialStringBufferLength];
   cciGetTargetTerminalName(&rc,
                            connection,
                            targetTerminalName,
                            initialStringBufferLength);
   /*Controllare ora i valori imprevisti nell'rc*/
   /*se rc è CCI_BUFFER_TOO_SMALL ridimensionarlo e riprovare*/
Concetti correlati
Sviluppo di uscite utente
Attività correlate
Sviluppo di un'uscita utente
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as36030_