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, o qual 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 em 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).
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);

Conceitos relacionados
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniBufferByte
cniBufferPointer
cniBufferSize
cniFinalize
cniSetInputBuffer