cniGetMessageContext

Obtém o endereço do contexto de mensagem associado à mensagem especificada. O contexto de uma mensagem existente é utilizado para criar uma mensagem de saída, por exemplo utilizando a função cniCreateMessage.

Sintaxe

CciMessageContext* cniGetMessageContext(
    int*            returnCode,
    CciMessage*        message);

Parâmetros

returnCode
O código de retorno da função (saída).
message
O endereço do objeto de mensagem (entrada).

Valores de Retorno

Se bem-sucedida, o endereço do contexto da mensagem é retornado. Caso contrário, zero (CCI_NULL_ADDR) é retornado e o parâmetro returnCode indica a razão do erro.

Exemplo

  outMsg = cniCreateMessage(&rc,
cniGetMessageContext(&rc, message));

Conceitos relacionados
Nós Input definidos pelo usuário
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Entrada em C
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniCreateMessage
cniDeleteMessage
cniFinalize
cniGetEnvironmentMessage
cniPropagate