WS_READ_MESSAGE_START_CALLBACK fonction de rappel (webservices.h)

Article
08/27/2023

Gère l’appel WsReadMessageStart pour un WS_CUSTOM_CHANNEL_BINDING.

Syntaxe

WS_READ_MESSAGE_START_CALLBACK WsReadMessageStartCallback;

HRESULT WsReadMessageStartCallback(
  [in]           void *channelInstance,
  [in]           WS_MESSAGE *message,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] channelInstance

Pointeur vers l’état spécifique à ce canal instance, tel que créé par le WS_CREATE_CHANNEL_CALLBACK.

[in] message

Message à recevoir.

[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

Code de retour	Description
S_OK	Le début du message a été reçu avec succès.
WS_S_END	Il n’y a plus de messages disponibles sur le canal.
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	Mémoire insuffisante.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

Remarques

Pour plus d’informations sur le contrat de cette API, consultez WsReadMessageStart .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	webservices.h

Share via