Función WsReadArray (webservices.h)

Lee una serie de elementos del lector e interpreta su contenido según el tipo de valor especificado.

Sintaxis

HRESULT WsReadArray(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 void                *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [out]          ULONG               *actualItemCount,
  [in, optional] WS_ERROR            *error
);

Parámetros

[in] reader

Lector desde el que se debe leer la matriz.

[in] localName

LocalName del elemento de repetición.

[in] ns

Espacio de nombres del elemento de repetición.

[in] valueType

Tipo de valor que se va a usar para analizar el contenido de cada elemento.

array

Matriz que se va a rellenar con valores analizados. El tamaño de los elementos de matriz viene determinado por el tipo de valor. Consulte WS_VALUE_TYPE para obtener más información.

[in] arraySize

Tamaño en bytes (no elementos) de la matriz.

[in] itemOffset

Desplazamiento del elemento (no byte) dentro de la matriz en la que se va a leer.

[in] itemCount

Número de elementos (no bytes) que se van a leer en la matriz.

[out] actualItemCount

Número real de elementos leídos. Puede ser menor que itemCount incluso cuando quedan más elementos. No hay más elementos cuando devuelve cero.

[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.
WS_E_QUOTA_EXCEEDED	Se superó una cuota.

Comentarios

Esta función es semánticamente equivalente al uso de WsReadStartElement, WsReadValue y WsReadEndElement en un bucle, pero es más eficaz.

Esta función puede producir un error por cualquiera de los motivos enumerados en WsReadNode.

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