Función WsGetHeaderAttributes (webservices.h)

Esta función rellena un parámetro ULONG con el WS_HEADER_ATTRIBUTES del elemento de encabezado en el que se coloca el lector. La versión de sobre del mensaje se usa para determinar qué atributos se van a devolver.

Sintaxis

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Parámetros

[in] message

Puntero a una estructura de WS_MESSAGE que contiene el mensaje que se va a consultar. Esta versión de sobre del mensaje se usa para determinar qué atributos coinciden. El mensaje puede estar en cualquier estado excepto WS_MESSAGE_STATE_EMPTY.

[in] reader

Puntero al lector que se va a consultar. Debe ser válido WS_XML_READER objeto devuelto por WsCreateReader y no puede ser NULL.

[out] headerAttributes

Si se ejecuta correctamente, el valor al que hace referencia este puntero se establece en los atributos de encabezado.

[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_OUTOFMEMORY	Se quedó sin memoria.
E_INVALIDARG	Uno o más argumentos no son válidos.
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Se supone que el lector apunta a un elemento de encabezado. Use la API del lector XML para colocar el lector correctamente.

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