cciGetSourceTerminalName

Essa função retorna o nome do terminal de saída do nó de origem para a conexão especificada.

Sintaxe

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

Parâmetros

returnCode (saída)
Recebe o código de retorno da função (saída).
  • CCI_BUFFER_TOO_SMALL

    O buffer fornecido não era grande o suficiente para manter o valor do nome do nó.

connection (entrada)
Esta é uma manipulação para uma conexão entre dois nós.
value (saída)
O endereço de um buffer, alocado pelo responsável pela chamada para manter o valor do nome do terminal.
length
O comprimento, em CciChars, do buffer alocado pelo responsável pela chamada.

Valores de Retorno

  • Se bem-sucedido, o nome do terminal é copiado para o buffer fornecido e o número de caracteres CciChar copiado é retornado.
  • Se o buffer não for grande o suficiente para conter o valor de atributo, returnCode será configurado como CCI_BUFFER_TOO_SMALL e o número de CciChars requeridos será retornado.

Exemplo

void myPropagatedMessageCallback(
                        CciDataContext* userContext,
                        CciMessage*        message,
                        CciMessage* localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage* environment,
                        CciConnection* connection){
int rc = CCI_SUCCESS;
   CciChar sourceTerminalName[initialStringBufferLength];
   cciGetSourceTerminalName(&rc,
                            connection,
                            sourceTerminalName,
                            initialStringBufferLength);
}
Conceitos relacionados
Saídas de usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:13

as36020_