IWMDRMSecurity::GetContentEnablersFromHashes method

Article
06/20/2023

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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

Requirement	Value
Header	Wmdrmsdk.h
Library	Wmdrmsdk.lib