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). Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_INV_MESSAGE_OBJECT
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));
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as07600_