IMFSSLCertificateManager::GetCertificatePolicy method (mfidl.h)
Indicates whether the server SSL certificate must be verified by the caller, Media Foundation, or the IMFSSLCertificateManager implementation class.
Syntax
HRESULT GetCertificatePolicy(
[in] LPCWSTR pszURL,
[out] BOOL *pfOverrideAutomaticCheck,
[out] BOOL *pfClientCertificateAvailable
);
Parameters
[in] pszURL
Pointer to a string that contains the URL that is sent to the server.
[out] pfOverrideAutomaticCheck
Pointer to a BOOL value. Set to TRUE if IMFSSLCertificateManager::OnServerCertificate is used to verify the server certificate. Set to FALSE if Media Foundation verifies the server certificate by using the certificates in the Windows certificate store.
[out] pfClientCertificateAvailable
Pointer to a BOOL value. Set to TRUE if the SSL certificate for the client is available for immediate retrieval. Media Foundation calls IMFSSLCertificateManager::GetClientCertificate to obtain the client certificate synchronously. If the value is set to FALSE, Media Foundation obtains the client SSL certificate with an asynchronous call to IMFSSLCertificateManager::BeginGetClientCertificate.
Return value
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 7 [desktop apps only] |
Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
Target Platform | Windows |
Header | mfidl.h |