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).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_FAILURE
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_CONTEXT
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));
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07570_