Interface IMFSSLCertificateManager (mfidl.h)
Implementado por um cliente e chamado pelo Microsoft Media Foundation para obter o certificado SSL (Secure Sockets Layer) do cliente solicitado pelo servidor.
Na maioria das conexões HTTPS, o servidor fornece um certificado para que o cliente possa garantir a identidade do servidor. No entanto, em determinados casos, o servidor pode querer verificar a identidade do cliente solicitando que o cliente envie um certificado. Para esse cenário, um aplicativo cliente deve fornecer um mecanismo para o Media Foundation recuperar o certificado do lado do cliente ao abrir uma URL HTTPS com o resolvedor de origem ou o manipulador de esquema. O aplicativo deve implementar IMFSSLCertificateManager, definir o ponteiro IUnknown do objeto implementado na propriedade MFNETSOURCE_SSLCERTIFICATE_MANAGER e passar o repositório de propriedades para o resolvedor de origem. Ao abrir a URL, a Media Foundation chama os métodos IMFSSLCertificateManager para obter as informações do certificado. Se o aplicativo precisar se conectar à URL HTTPS que exija um certificado do lado do cliente ou se o aplicativo quiser um controle personalizado sobre o tipo de certificados de servidor a ser aceito, ele poderá implementar essa interface. Essa interface também pode ser usada pelo aplicativo para validar o certificado SSL do servidor.
Se o ponteiro IUnknown não for fornecido pelo aplicativo e a URL HTTPS não exigir que o cliente forneça um certificado, o Media Foundation usará a implementação padrão para abrir a URL.
Herança
A interface IMFSSLCertificateManager herda da interface IUnknown . IMFSSLCertificateManager também tem estes tipos de membros:
Métodos
A interface IMFSSLCertificateManager tem esses métodos.
IMFSSLCertificateManager::BeginGetClientCertificate Inicia uma chamada assíncrona para obter o certificado SSL do cliente. |
IMFSSLCertificateManager::EndGetClientCertificate Conclui uma solicitação assíncrona para obter o certificado SSL do cliente. |
IMFSSLCertificateManager::GetCertificatePolicy Indica se o certificado SSL do servidor deve ser verificado pelo chamador, Media Foundation ou pela classe de implementação IMFSSLCertificateManager. |
IMFSSLCertificateManager::GetClientCertificate Obtém o certificado SSL do cliente de forma síncrona. |
IMFSSLCertificateManager::OnServerCertificate Chamado pelo Media Foundation quando o certificado SSL do servidor foi recebido; indica se o certificado do servidor é aceito. |
Requisitos
Cliente mínimo com suporte | Windows 7 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | mfidl.h |