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

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:07

as07670_