IMFSSLCertificateManager::BeginGetClientCertificate method (mfidl.h)

Article
10/13/2021

Starts an asynchronous call to get the client SSL certificate.

Syntax

HRESULT BeginGetClientCertificate(
  [in] LPCWSTR          pszURL,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *pState
);

Parameters

[in] pszURL

A null-terminated string that contains the URL for which a client-side SSL certificate is required. Media Foundation can resolve the scheme and send the request to the server.

[in] pCallback

A pointer to the IMFAsyncCallback interface of a callback object. The caller must implement this interface.

[in] pState

A pointer to the IUnknown interface of a state object, defined by the caller. This parameter can be NULL. You can use this object to hold state information. The object is returned to the caller when the callback is invoked.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When the operation completes, the callback object's IMFAsyncCallback::Invoke method is called. At that point, the application should call IMFSSLCertificateManager::EndGetClientCertificate to complete the asynchronous request.

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