Fonction WsReadArray (webservices.h)

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.

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