Función WsReadEndpointAddressExtension (webservices.h)

  • Artículo

Lee una extensión del WS_ENDPOINT_ADDRESS.

Sintaxis

HRESULT WsReadEndpointAddressExtension(
  [in]           WS_XML_READER                      *reader,
  [in]           WS_ENDPOINT_ADDRESS                *endpointAddress,
  [in]           WS_ENDPOINT_ADDRESS_EXTENSION_TYPE extensionType,
  [in]           WS_READ_OPTION                     readOption,
  [in]           WS_HEAP                            *heap,
                 void                               *value,
  [in]           ULONG                              valueSize,
  [in, optional] WS_ERROR                           *error
);

Parámetros

[in] reader

Lector XML que se va a usar para leer la extensión.

La función establecerá automáticamente la entrada del lector según sea necesario para leer las extensiones.

[in] endpointAddress

Dirección del punto de conexión que contiene las extensiones.

[in] extensionType

Tipo de extensión que se va a leer.

[in] readOption

Indica si el valor es necesario y cómo asignar el valor. Consulte WS_READ_OPTION para obtener más información.

Este parámetro debe tener uno de los valores siguientes:

[in] heap

Montón que se va a usar para almacenar el valor que se lee.

value

Dirección de un búfer para colocar el valor leído.

Si usa WS_READ_REQUIRED_VALUE para el parámetro readOption, el búfer debe ser el tamaño del tipo de extensión que se va a leer (que varía según WS_ENDPOINT_ADDRESS_EXTENSION_TYPE).

Si usa WS_READ_REQUIRED_POINTER o WS_READ_OPTIONAL_POINTER, el búfer debe ser el tamaño de un puntero.

[in] valueSize

Tamaño del búfer que el autor de la llamada ha asignado para el valor leído.

Este tamaño debe corresponder al tamaño del búfer pasado mediante el parámetro value.

[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
E_INVALIDARG
 El tipo de extensión no era válido.

El tamaño del búfer proporcionado no era correcto.

Un parámetro requerido era NULL.
WS_E_INVALID_FORMAT
 Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
E_OUTOFMEMORY
 Se quedó sin memoria.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

El valor devuelto es válido hasta que el montón se libera o restablece.

Si el tipo de extensión solicitado aparece más de una vez en el búfer de extensiones, se devuelve la primera instancia.

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