Función WsWriteAttribute (webservices.h)

Escriba un valor con tipo como un atributo XML.

Sintaxis

HRESULT WsWriteAttribute(
  [in]           WS_XML_WRITER                  *writer,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [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 atributo.

[in] attributeDescription

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

[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 atributo start, el valor de atributo y el atributo end.

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

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