Partager via

WS_GET_CERT_CALLBACK fonction de rappel (webservices.h)

  • Article

Fournit un certificat au runtime de sécurité. Ce rappel est spécifié dans le cadre du WS_CUSTOM_CERT_CREDENTIAL, qui à son tour peut être spécifié dans le cadre d’une liaison de sécurité qui nécessite des informations d’identification de certificat. Le runtime appelle ce rappel lorsque le canal (côté client) ou l’écouteur (côté serveur) est ouvert.

Propriété du certificat : si ce rappel retourne un HRESULT réussi, l’appelant (à savoir, le runtime de sécurité) prend possession du certificat retourné et le libère lorsque le canal contenant n’en a plus besoin. Si ce rappel retourne une erreur HRESULT, l’appelant ne prend PAS en charge la valeur renvoyée dans le paramètre de sortie « cert ».

Syntaxe

WS_GET_CERT_CALLBACK WsGetCertCallback;

HRESULT WsGetCertCallback(
  [in]           void *getCertCallbackState,
  [in, optional] const WS_ENDPOINT_ADDRESS *targetAddress,
  [in, optional] const WS_STRING *viaUri,
                 const _CERT_CONTEXT **cert,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] getCertCallbackState

État spécifié avec ce rappel dans les informations d’identification du certificat.

[in, optional] targetAddress

Adresse cible à laquelle ce certificat doit être présenté, dans le cas où ces informations d’identification de certificat sont spécifiées pour un client.

[in, optional] viaUri

adresse via laquelle ce certificat doit être présenté.

cert

Emplacement où retourner le certificat.

[in, optional] error

Spécifie l’emplacement où les informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction de rappel ne retourne pas de valeur.

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