IMFSSLCertificateManager::BeginGetClientCertificate method (mfidl.h)

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

See also

Calling Asynchronous Methods

IMFSSLCertificateManager