cniWriteBuffer

Esta función escribe el árbol de elementos de sintaxis asociado con el mensaje especificado en el almacenamiento intermedio de datos perteneciente al objeto de mensaje. Esta función la utilizan normalmente los nodos de salida. Esta operación serializa el árbol de elementos en una corriente de bits que, posteriormente, puede procesarse como una secuencia de bytes contiguos. Esta función debe utilizarse al escribir la corriente de bits en un destino que esté fuera del intermediario.

Antes de invocar esta función, debe invocar cniFinalize; de lo contrario, no funcionará.

Sintaxis

void cniWriteBuffer(
  int*         returnCode,
  CciMessage*  message);

Parámetros

returnCode
Código de retorno de la función (salida).
message
Dirección del objeto de mensaje para el que va a serializarse el árbol de elementos (entrada).

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la causa de dicho error.

Ejemplo

cniCopyElementTree(&rc, inLastChild, outLastChild);
cniFinalize(&rc, outMessage);
cniWriteBuffer(&rc, outMessage);

Conceptos relacionados
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de programa de utilidad de nodo de lenguaje C
cniBufferByte
cniBufferPointer
cniBufferSize
cniFinalize
cniSetInputBuffer