Compartir a través de

Función WsWriteElement (webservices.h)

  • Artículo

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.

Código devuelto Descripción
WS_E_INVALID_FORMAT
 Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
E_INVALIDARG
 Uno o más argumentos no son válidos.
E_OUTOFMEMORY
 Se quedó sin memoria.

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

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll