WS_CERTIFICATE_VALIDATION_CALLBACK fonction de rappel (webservices.h)

Article
08/27/2023

Le rappel WS_CERTIFICATE_VALIDATION_CALLBACK est appelé pour valider un certificat lorsqu’une connexion à un serveur HTTP a été établie et que des en-têtes ont été envoyés.

Syntaxe

WS_CERTIFICATE_VALIDATION_CALLBACK WsCertificateValidationCallback;

HRESULT WsCertificateValidationCallback(
  [in]           PCCERT_CONTEXT certContext,
  [in, optional] void *state
)
{...}

Paramètres

[in] certContext

Pointeur vers une structure de CERT_CONTEXT associée à la connexion. Les applications doivent libérer cette structure à l’aide de CertFreeCertificateContext.

[in, optional] state

Pointeur vers les informations d’état spécifiques à l’application. Ce paramètre correspond au membre d’état de la structure WS_CERTIFICATE_VALIDATION_CALLBACK_CONTEXT .

Valeur retournée

Cette fonction de rappel peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Le certificat a été validé avec succès.
Autres erreurs	Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Si WS_CERTIFICATE_VALIDATION_CALLBACK retourne une valeur autre que S_OK, le canal est abandonné. Le proxy de service sera également abandonné si cette propriété a été transmise à WsCreateServiceProxy.

L’implémentation du rappel doit éviter de longs temps de calcul ou de longs appels bloquants afin qu’elle retourne rapidement à l’appelant.

Configuration requise


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

Voir aussi

WS_CERTIFICATE_VALIDATION_CALLBACK_CONTEXT

Partager via