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

Confira também

Media Foundation Interfaces