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

See also

IMFSSLCertificateManager