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));
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as07570_