Función WsWriteElement (webservices.h)

Escriba un valor con tipo como un elemento XML.

Sintaxis

HRESULT WsWriteElement(
  [in]           WS_XML_WRITER                *writer,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

Parámetros

[in] writer

Escritor en el que se va a escribir el elemento.

[in] elementDescription

Puntero a una descripción de cómo serializar el elemento.

[in] writeOption

Información sobre cómo se asigna el valor. Consulte WS_WRITE_OPTION para obtener más información.

value

Puntero al valor que se va a serializar.

[in] valueSize

Tamaño del valor que se serializa, en bytes.

Si el valor es NULL, el tamaño debe ser 0.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Comentarios

Esta API escribe el elemento start, los atributos, los elementos secundarios/texto y el elemento final que corresponde al valor especificado.

Si se produce un error en la API, el estado del escritor de entrada se vuelve indefinido. Las únicas API que se pueden usar en el escritor si esto ocurre son WsSetOutput y WsSetOutputToBuffer para devolver el escritor a un estado utilizable, o WsFreeWriter para liberar el escritor.

Requisitos