WsWriteArray, fonction (webservices.h)

Article
03/13/2024

Cette opération envoie une série d’éléments à un enregistreur XML.

Syntaxe

HRESULT WsWriteArray(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 const void          *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [in, optional] WS_ERROR            *error
);

Paramètres

[in] writer

Pointeur vers l’enregistreur où les éléments sont écrits.

[in] localName

Pointeur vers le localName de l’élément répétiteur.

[in] ns

Pointeur vers l’espace de noms de l’élément répétiteur.

[in] valueType

Type de valeur pour les éléments

array

Pointeur void vers les valeurs écrites dans writer. La taille des éléments est déterminée par type valeur.

Note Pour plus d’informations, consultez WS_VALUE_TYPE .

[in] arraySize

Longueur totale en octets du tableau.

[in] itemOffset

Décalage d’élément dans le tableau à écrire.

[in] itemCount

Nombre total d’éléments à écrire à partir du tableau.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette fonction équivaut sémantiquement à utiliser WsWriteStartElement, WsWriteValue et WsWriteEndElement dans une boucle, mais elle est plus efficace.

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

Partager via