Función WsReadType (webservices.h)

  • Artículo

Lea un valor de un WS_TYPE determinado de XML según el WS_TYPE_MAPPING.

Sintaxis

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parámetros

[in] reader

Lector situado en el XML que se va a deserializar.

[in] typeMapping

Describe cómo se asigna el tipo al XML que se está leyendo.

[in] type

Tipo del valor que se va a deserializar.

[in, optional] typeDescription

Información adicional sobre el tipo. Cada tipo tiene una estructura de descripción diferente. Puede ser NULL, dependiendo del WS_TYPE.

[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, optional] heap

Montón en el que se almacenarán los valores deserializados.

value

La interpretación de este parámetro depende del WS_READ_OPTION.

[in] valueSize

La interpretación de este parámetro depende del WS_READ_OPTION.

[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_OUTOFMEMORY
 Se quedó sin memoria.
WS_E_QUOTA_EXCEEDED
 Se superó la cuota de tamaño del montón.
E_INVALIDARG
 Uno o más argumentos no son válidos.

Comentarios

Consulte WS_TYPE_MAPPING para obtener información sobre cómo usar esta función para leer valores de elementos y atributos.

Si se produce un error en la API, el estado del lector de entrada deja de definirse. Las únicas API que se pueden usar en el lector si esto ocurre son WsSetInput y WsSetInputToBuffer para devolver el lector a un estado utilizable o WsFreeReader para liberar al lector.

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