Fonction WsReadArray (webservices.h)

  • Article

Lit une série d’éléments à partir du lecteur et interprète leur contenu en fonction du type de valeur spécifié.

Syntaxe

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
);

Paramètres

[in] reader

Lecteur à partir duquel le tableau doit être lu.

[in] localName

LocalName de l’élément répétiteur.

[in] ns

Espace de noms de l’élément répétiteur.

[in] valueType

Type de valeur à utiliser pour analyser le contenu de chaque élément.

array

Tableau à remplir avec des valeurs analysées. La taille des éléments de tableau est déterminée par le type de valeur. Pour plus d’informations , consultez WS_VALUE_TYPE .

[in] arraySize

Taille en octets (et non en éléments) du tableau.

[in] itemOffset

Décalage d’élément (et non d’octet) dans le tableau à lire.

[in] itemCount

Nombre d’éléments (et non d’octets) à lire dans le tableau.

[out] actualItemCount

Nombre réel d’éléments qui ont été lus. Cela peut être inférieur à itemCount même s’il reste plus d’éléments. Il n’y a plus d’éléments lorsque cela retourne zéro.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
WS_E_INVALID_FORMAT
 Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
WS_E_QUOTA_EXCEEDED
 Un quota a été dépassé.

Remarques

Cette fonction équivaut sémantiquement à l’utilisation de WsReadStartElement, WsReadValue et WsReadEndElement dans une boucle, mais est plus efficace.

Cette fonction peut échouer pour l’une des raisons répertoriées dans WsReadNode.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête webservices.h
Bibliothèque WebServices.lib
DLL WebServices.dll