WsGetHeaderAttributes, fonction (webservices.h)

Article
03/13/2024

Cette fonction remplit un paramètre ULONG avec le WS_HEADER_ATTRIBUTES de l’élément header sur lequel le lecteur est positionné. La version d’enveloppe du message est utilisée pour déterminer les attributs à retourner.

Syntaxe

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] message

Pointeur vers une structure de WS_MESSAGE contenant le message à interroger. Cette version d’enveloppe du message est utilisée pour déterminer les attributs qui correspondent. Le message peut être dans n’importe quel état, à l’exception de WS_MESSAGE_STATE_EMPTY.

[in] reader

Pointeur vers le lecteur à interroger. Cela doit être valide WS_XML_READER objet retourné par WsCreateReader et ne peut pas être NULL.

[out] headerAttributes

En cas de réussite, la valeur référencée par ce pointeur est définie sur les attributs d’en-tête.

[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

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
E_OUTOFMEMORY	Nous avons manqué de mémoire.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
WS_E_INVALID_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Le lecteur est supposé pointer vers un élément d’en-tête. Utilisez l’API de lecteur XML pour positionner le lecteur de manière appropriée.

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