Partager via

WsRequestReply, fonction (webservices.h)

  • Article

Permet d’envoyer un message de demande et de recevoir un message de réponse corrélé.

Syntaxe

HRESULT WsRequestReply(
  [in]           WS_CHANNEL                   *channel,
  [in]           WS_MESSAGE                   *requestMessage,
  [in]           const WS_MESSAGE_DESCRIPTION *requestMessageDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *requestBodyValue,
  [in]           ULONG                        requestBodyValueSize,
  [in]           WS_MESSAGE                   *replyMessage,
  [in]           const WS_MESSAGE_DESCRIPTION *replyMessageDescription,
  [in]           WS_READ_OPTION               readOption,
  [in, optional] WS_HEAP                      *heap,
                 void                         *value,
  [in]           ULONG                        valueSize,
  [in, optional] const WS_ASYNC_CONTEXT       *asyncContext,
  [in, optional] WS_ERROR                     *error
);

Paramètres

[in] channel

Canal sur lequel effectuer l’opération demande-réponse.

[in] requestMessage

Objet de message à utiliser pour envoyer la demande.

L’objet message doit être dans WS_MESSAGE_STATE_EMPTY ou WS_MESSAGE_STATE_INITIALIZED.

[in] requestMessageDescription

Le champ d’action du WS_MESSAGE_DESCRIPTION est utilisé comme en-tête d’action pour le message de demande. Ce champ peut être NULL si aucune action n’est requise.

Le champ bodyElementDescription du WS_MESSAGE_DESCRIPTION est utilisé pour sérialiser le corps du message de demande. Ce champ peut être NULL si aucun élément body n’est souhaité. Consultez WsWriteBody pour plus d’informations sur la façon dont le corps est sérialisé selon bodyElementDescription.

[in] writeOption

Indique si l’élément body est requis et comment la valeur est allouée. Pour plus d’informations, consultez WS_WRITE_OPTION .

requestBodyValue

Pointeur vers la valeur à sérialiser dans le corps de l’objet de requête.

[in] requestBodyValueSize

Taille de la valeur de la requête en cours de sérialisation, en octets.

[in] replyMessage

Objet message à utiliser pour recevoir la réponse.

L’objet message doit être dans WS_MESSAGE_STATE_EMPTY.

[in] replyMessageDescription

Le champ d’action du WS_MESSAGE_DESCRIPTION est utilisé pour vérifier l’en-tête d’action du message de réponse reçu. Ce champ peut être NULL si aucune action n’est requise. Si la valeur est NULL, l’en-tête d’action du message reçu est ignoré s’il est présent.

Le champ bodyElementDescription du WS_MESSAGE_DESCRIPTION est utilisé pour désérialiser le corps du message de réponse. Ce champ peut être NULL si aucun élément body n’est souhaité. Consultez WsReadBody pour plus d’informations sur la façon dont le corps est désérialisé selon bodyElementDescription.

[in] readOption

Indique si l’élément de corps de réponse est requis et comment allouer la valeur. Pour plus d’informations, consultez WS_READ_OPTION et WsReadBody.

[in, optional] heap

Tas utilisé pour allouer des valeurs de corps de réponse désérialisées. Si le tas n’est pas nécessaire pour le type donné, ce paramètre peut être NULL.

value

Où stocker les valeurs désérialisées du corps.

L’interprétation de ce paramètre dépend du WS_READ_OPTION.

Si bodyElementDescription du WS_MESSAGE_DESCRIPTION de réponse a la valeur NULL, ce paramètre n’est pas touché. Dans ce cas, le paramètre n’a pas besoin d’être spécifié.

[in] valueSize

L’interprétation de ce paramètre dépend du WS_READ_OPTION.

[in, optional] asyncContext

Informations sur la façon d’appeler la fonction de manière asynchrone, ou NULL en cas d’appel synchrone.

[in, optional] error

Spécifie l’emplacement où des 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_ENDPOINT_FAULT_RECEIVED
 Le message de réponse contenait une erreur. L’erreur peut être extraite du WS_ERROR à l’aide de WsGetErrorProperty.
WS_S_ASYNC
 L’opération asynchrone est toujours en attente.
WS_E_OPERATION_ABORTED
 L'opération a été abandonnée.
WS_E_INVALID_OPERATION
 L’opération n’est pas autorisée en raison de l’état actuel de l’objet.
WS_E_ENDPOINT_NOT_FOUND
 Le point de terminaison distant n’existe pas ou n’a pas pu être localisé.
WS_E_ENDPOINT_ACCESS_DENIED
 L’accès a été refusé par le point de terminaison distant.
WS_E_ENDPOINT_DISCONNECTED
 La connexion avec le point de terminaison distant a été interrompue.
WS_E_ENDPOINT_FAILURE
 Le point de terminaison distant n’a pas pu traiter la demande.
WS_E_ENDPOINT_NOT_AVAILABLE
 Le point de terminaison distant n’est actuellement pas en service à cet emplacement.
WS_E_ENDPOINT_TOO_BUSY
 Le point de terminaison distant ne peut pas traiter la demande en raison d’une surcharge.
WS_E_ENDPOINT_UNREACHABLE
 Le point de terminaison distant n’était pas accessible.
WS_E_INVALID_ENDPOINT_URL
 L’URL de l’adresse du point de terminaison n’est pas valide.
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_OPERATION_TIMED_OUT
 L’opération ne s’est pas terminée dans le délai imparti.
WS_E_PROXY_ACCESS_DENIED
 L’accès a été refusé par le serveur proxy HTTP.
WS_E_PROXY_FAILURE
 Le serveur proxy HTTP n’a pas pu traiter la requête.
WS_E_QUOTA_EXCEEDED
 Un quota a été dépassé.
WS_E_SECURITY_VERIFICATION_FAILURE
 La vérification de sécurité n’a pas réussi pour les données reçues.
WS_E_SECURITY_SYSTEM_FAILURE
 Une opération de sécurité a échoué dans l’infrastructure des services Web Windows.
WS_E_SECURITY_TOKEN_EXPIRED
 Un jeton de sécurité a été rejeté par le serveur, car il a expiré.
WS_E_PROXY_REQUIRES_BASIC_AUTH
 Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « de base ».
WS_E_PROXY_REQUIRES_DIGEST_AUTH
 Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « digest ».
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH
 Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « negotiate ».
WS_E_PROXY_REQUIRES_NTLM_AUTH
 Le serveur proxy HTTP nécessite le schéma d’authentification HTTP « NTLM ».
WS_E_SERVER_REQUIRES_BASIC_AUTH
 Le point de terminaison distant nécessite le schéma d’authentification HTTP « de base ».
WS_E_SERVER_REQUIRES_DIGEST_AUTH
 Le point de terminaison distant nécessite le schéma d’authentification HTTP « digest ».
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH
 Le point de terminaison distant nécessite le schéma d’authentification HTTP « negotiate ».
WS_E_SERVER_REQUIRES_NTLM_AUTH
 Le point de terminaison distant nécessite le schéma d’authentification HTTP « NTLM ».
CERT_E_EXPIRED
 Un certificat requis n’est pas dans sa période de validité lors de la vérification par rapport à l’horloge système actuelle ou à l’horodatage dans le fichier signé.
CERT_E_CN_NO_MATCH
 Le nom CN des certificats ne correspond pas à la valeur passée.
CERT_E_UNTRUSTEDROOT
 Chaîne de certificats traitée, mais terminée dans un certificat racine qui n’est pas approuvé par le fournisseur d’approbation.
CERT_E_WRONG_USAGE
 Le certificat n'est pas valide pour l'utilisation demandée.
CRYPT_E_REVOCATION_OFFLINE
 La fonction de révocation n’a pas pu vérifier la révocation car le serveur de révocation était déconnecté.
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

Les messages sont corrélés en fonction du WS_ADDRESSING_VERSION. Pour plus d’informations sur la corrélation des messages de réponse aux demandes, consultez Vue d’ensemble de la couche de canal.

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