IMFSSLCertificateManager 接口 (mfidl.h)
由客户端实现并由 Microsoft Media Foundation 调用,以获取客户端安全套接字层 (SSL) 服务器请求的证书。
在大多数 HTTPS 连接中,服务器提供证书,以便客户端可以确保服务器的标识。 但是,在某些情况下,服务器可能希望通过请求客户端发送证书来验证客户端的身份。 对于此方案,客户端应用程序必须提供一种机制,以便媒体基础在使用源解析程序或方案处理程序打开 HTTPS URL 时检索客户端证书。 应用程序必须实现 IMFSSLCertificateManager,在 MFNETSOURCE_SSLCERTIFICATE_MANAGER 属性中设置实现对象的 IUnknown 指针,并将属性存储传递给源解析程序。 打开 URL 时,Media Foundation 调用 IMFSSLCertificateManager 方法来获取证书信息。 如果应用程序需要连接到需要客户端证书的 HTTPS URL,或者应用程序需要对要接受的服务器证书类型进行自定义控制,则可以实现此接口。 应用程序还可以使用此接口来验证服务器 SSL 证书。
如果应用程序未提供 IUnknown 指针,并且 HTTPS URL 不要求客户端提供证书,则 Media Foundation 使用默认实现打开 URL。
继承
IMFSSLCertificateManager 接口继承自 IUnknown 接口。 IMFSSLCertificateManager 也具有以下类型的成员:
方法
IMFSSLCertificateManager 接口具有这些方法。
IMFSSLCertificateManager::BeginGetClientCertificate 启动异步调用以获取客户端 SSL 证书。 |
IMFSSLCertificateManager::EndGetClientCertificate 完成获取客户端 SSL 证书的异步请求。 |
IMFSSLCertificateManager::GetCertificatePolicy 指示服务器 SSL 证书是否必须由调用方、媒体基础或 IMFSSLCertificateManager 实现类进行验证。 |
IMFSSLCertificateManager::GetClientCertificate 同步获取客户端 SSL 证书。 |
IMFSSLCertificateManager::OnServerCertificate 在收到服务器 SSL 证书时由媒体基础调用;指示是否接受服务器证书。 |
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | mfidl.h |