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 |