Fonction WsReadEnvelopeEnd (webservices.h)

  • Article

Lit les éléments fermants d’un message.

L’opération permet de lire des messages provenant de sources autres que canaux. Si la source est un canal, utilisez WsReadMessageEnd.

Syntaxe

HRESULT WsReadEnvelopeEnd(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

Paramètres

[in] message

Pointeur vers l’objet Message lu. Le pointeur doit référencer un WS_MESSAGE valide.

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

Remarques

L’état du message doit être WS_MESSAGE_STATE_READING. S’il est appelé dans l’état correct, l’état du message est défini sur WS_MESSAGE_STATE_DONE indépendamment de la réussite ou de l’échec de la fonction.

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