cciNodeCompletionCallback

A função cciNodeCompletionCallback pode ser registrada como um retorno de chamada e é chamada sempre que um nó conclui o processamento de uma mensagem e está retornando o controle para seu nó de envio de dados.

A função cciNodeCompletionCallback é chamada para cada mensagem propagada no grupo de execução onde o retorno de chamada foi registrado, se o estado de saída do usuário estiver ativo. O retorno de chamada é registrado fornecendo um ponteiro para a função como o campo iFpNodeCompletionCallback da estrutura CCI_UE_VFT transmitida para cciRegisterUserExit.

Se o nó for concluído devido a uma exceção não-manipulada, ele retornará com um reasonCode CCI_EXCEPTION e os detalhes dessa exceção poderão ser obtidos chamando cciGetLastExceptionData.

Se o nó for concluído normalmente (incluindo a manipulação de uma exceção no terminal de captura ou de falha), ele retornará com um reasonCode de CCI_SUCCESS. Nesse caso, a chamada de cciGetLastExceptionData retorna resultados imprevisíveis.

Sintaxe

typedef void (*cciNodeCompletionCallback) (
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage* localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage* environment,
                                 CciConnection* connection,
                                 int reasonCode);

Parâmetros

userContext (entrada)
O valor transmitido para a função cciRegisterUserExit.
message
Um identificador para o objeto de mensagem atual. A mensagem atual é a mensagem que é propagada para o nó mais modificações que são aplicadas à raiz de entrada no nó.
localEnvironment
Um identificador para o objeto do ambiente local que está sendo propagado.
exceptionList
Um identificador para o objeto da lista de exceções que está sendo propagado.
environment
Um identificador para o objeto de ambiente para o fluxo de mensagens atual.
connection
Um identificador para o objeto de conexão entre os dois nós. O identificador pode ser utilizado, por exemplo, em chamadas para cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName e cciGetTargetTerminalName. Esta manipulação é válida apenas pela duração desta instância da função de saída de usuário.
reasonCode
Um código de razão que indica se o nó foi concluído normalmente (CCI_SUCCESS) ou se o nó foi concluído como resultado de uma exceção não-manipulada (CCI_EXCEPTION). Se o nó for concluído devido a uma exceção não-manipulada, você poderá obter os detalhes dessa exceção chamando cciGetLastExceptionData. Se o nó for concluído normalmente (incluindo a manipulação de uma exceção no terminal de captura ou de falha), o efeito de chamar cciGetLastExceptionData será indeterminado.

Valores de Retorno

Nenhum.

Exemplo

void myNodeCompletionCallback(
                                 CciDataContext* userContext,
                                 CciMessage*        message,
                                 CciMessage* localEnvironment,
                                 CciMessage* exceptionList,
                                 CciMessage* environment,
                                 CciConnection* connection
                                 int reasonCode){
…
…
}
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

as35940_