Início da mudança

cciGetTargetTerminalName

Esta função retorna o nome do terminal de entrada do nó de destino para a conexão especificada.

Sintaxe

CciSize cciGetTargetTerminalName (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 nome do terminal, returnCode será definido como CCI_BUFFER_TOO_SMALL, e o número de CciChars exigido será retornado.

Exemplo

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);
/* agora verifique o rc a procura de valores inesperados*/
/* se rc é CCI_BUFFER_TOO_SMALL, você deve redimensionar e tentar novamente*/
Conceitos relacionados
Desenvolvendo Saídas do Usuário
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as36030_


Fim da mudança