cniCreateMessage

Cria um novo objeto de mensagem de saída. Para toda chamada a esta função deve haver uma chamada correspondente a cniDeleteMessage para retornar os recursos alocados quando o processamento da mensagem de saída tiver sido concluído.

Sintaxe

CciMessage* cniCreateMessage(
    int*            returnCode,
    CciMessageContext*  messageContext);

Parâmetros

returnCode
O código de retorno da função (saída).
messageContext
O endereço do contexto para a mensagem (entrada). Utilize cniGetMessageContext para obter o contexto de uma mensagem de entrada (por exemplo, uma recebida na função cniEvaluate).

Valores de Retorno

Se bem-sucedida, o endereço do objeto de mensagem é retornado. Caso contrário, um valor de 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
cniDeleteMessage
cniEvaluate
cniFinalize
cniGetEnvironmentMessage
cniGetMessageContext
cniPropagate