IWMDRMSecurity::GetContentEnablersFromHashes method

The GetContentEnablersFromHashes method retrieves content enabler interfaces that enable renewal of components based on hashed certificates.

Syntax

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parameters

rgpbCertHashes [in]

Array of certificate hashes to obtain content enablers for.

cCerts [in]

Number of certificates to retrieve content enablers for. This is the number of elements in the rgpbCertHashes array.

hResultHint [in]

Return value received from the operation that failed due to a revoked certificate. If you are not calling in response to a failed method call, set to S_OK.

prgContentEnablers [out]

Array that receives the addresses of the newly created IMFContentEnabler interfaces. Set to NULL to get the number of content enablers in the pcContentEnablers parameter.

pcContentEnablers [in, out]

Number of elements in the prgContentEnablers array. If prgContentEnablers is NULL, this value is set to the number of needed content enablers on output.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.

Remarks

If you use the IMFContentEnabler interface to renew revoked components, you must clarify the process to the user. This clarification must be made because the update process sends information from the client computer to a Microsoft Web site.

When you call IMFContentEnabler::AutomaticEnable, the content enabler launches the default browser with the address of the update service on the Microsoft Web site. A unique identifier that identifies the revoked component is sent to the update service. The service then redirects the browser to a Web page from which the user may be able to download and install the new version of the revoked component.

Requirements

Header
Wmdrmsdk.h
Library
Wmdrmsdk.lib

See also

IWMDRMSecurity Interface