cniWriteBuffer

Grava a árvore de elementos de sintaxe associada à mensagem especificada no buffer de dados de propriedade daquele objeto de mensagem. Essa função é utilizada tipicamente por nós de saída. Essa operação serializa a árvore de elementos em um fluxo de bits que pode então ser processado como uma seqüência de bytes contíguos. Essa função deve ser utilizada ao gravar o fluxo de bits para um destino que esteja fora do intermediário.

É preciso chamar cniFinalize antes dessa chamada, ou ela não funcionará.

Sintaxe

void cniWriteBuffer(
    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_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
O endereço do objeto de mensagem para o qual a árvore de elementos deve ser serializada (entrada).

Valores de Retorno

Nenhuma. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Exemplo

cniCopyElementTree(&rc, inLastChild, outLastChild);
cniFinalize(&rc, outMessage);
cniWriteBuffer(&rc, outMessage);
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07670_