Partager via


Interface IMFSSLCertificateManager (mfidl.h)

Implémenté par un client et appelé par Microsoft Media Foundation pour obtenir le certificat SSL (Secure Sockets Layer) du client demandé par le serveur.

Dans la plupart des connexions HTTPS, le serveur fournit un certificat afin que le client puisse s’assurer de l’identité du serveur. Toutefois, dans certains cas, le serveur peut vouloir vérifier l’identité du client en demandant au client d’envoyer un certificat. Pour ce scénario, une application cliente doit fournir un mécanisme permettant à Media Foundation de récupérer le certificat côté client lors de l’ouverture d’une URL HTTPS avec le programme de résolution source ou le gestionnaire de schéma. L’application doit implémenter IMFSSLCertificateManager, définir le pointeur IUnknown de l’objet implémenté dans la propriété MFNETSOURCE_SSLCERTIFICATE_MANAGER et passer le magasin de propriétés au programme de résolution source. Lors de l’ouverture de l’URL, Media Foundation appelle les méthodes IMFSSLCertificateManager pour obtenir les informations de certificat. Si l’application doit se connecter à une URL HTTPS qui nécessite un certificat côté client, ou si l’application souhaite un contrôle personnalisé sur le type de certificats de serveur à accepter, elle peut implémenter cette interface. Cette interface peut également être utilisée par l’application pour valider le certificat SSL du serveur.

Si le pointeur IUnknown n’est pas fourni par l’application et que l’URL HTTPS ne nécessite pas que le client fournisse un certificat, Media Foundation utilise l’implémentation par défaut pour ouvrir l’URL.

Héritage

L’interface IMFSSLCertificateManager hérite de l’interface IUnknown. IMFSSLCertificateManager a également les types de membres suivants :

Méthodes

L’interface IMFSSLCertificateManager utilise ces méthodes.

 
IMFSSLCertificateManager::BeginGetClientCertificate

Démarre un appel asynchrone pour obtenir le certificat SSL client.
IMFSSLCertificateManager::EndGetClientCertificate

Termine une demande asynchrone pour obtenir le certificat SSL client.
IMFSSLCertificateManager::GetCertificatePolicy

Indique si le certificat SSL du serveur doit être vérifié par l’appelant, Media Foundation ou la classe d’implémentation IMFSSLCertificateManager.
IMFSSLCertificateManager::GetClientCertificate

Obtient le certificat SSL client de manière synchrone.
IMFSSLCertificateManager::OnServerCertificate

Appelé par Media Foundation lorsque le certificat SSL du serveur a été reçu ; indique si le certificat de serveur est accepté.

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 mfidl.h

Voir aussi

Interfaces Media Foundation