Función WsWriteValue (webservices.h)

Esta operación deriva la mejor representación de un valor primitivo de la codificación subyacente y pasa el valor derivado a un objeto Writer.

Nota Por lo general, es más eficaz usar esta función para escribir valores primitivos en lugar de convertir el valor en texto y, posteriormente, usar WsWriteChars.

 

Sintaxis

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

Parámetros

[in] writer

Puntero al objeto WS_XML_WRITER en el que se escribe el valor. El puntero debe hacer referencia a un objeto de escritura XML válido.

[in] valueType

Indica el tipo de valor primitivo al que hace referencia el parámetro value .

I

value

Puntero void al valor primitivo.

[in] valueSize

Tamaño en bytes del valor que se está escribiendo.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error 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
E_INVALIDARG	Uno o más argumentos no son válidos.
WS_E_INVALID_OPERATION	No se permite la operación debido al estado actual del objeto .

Comentarios

Se puede llamar a WsWriteValue solo una vez entre WsWriteStartAttribute y WsWriteEndAttribute. No se puede combinar con WsWriteChars, WsWriteBytes, WsWriteCharsUtf8 o WsWriteText al escribir un atributo.

Requisitos

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