IWMDRMSecurity::GetContentEnablersForRevocations method
[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 GetContentEnablersForRevocations method retrieves content enabler interfaces that enable renewal of components based on revoked certificates.
Syntax
HRESULT GetContentEnablersForRevocations(
[in] BYTE **rgpbCerts,
[in] DWORD *rgpdwCertSizes,
[in] GUID **rgpguidCerts,
[in] DWORD cCerts,
[in] HRESULT hResultHint,
[out] IMFContentEnabler **prgContentEnablers,
[in, out] DWORD *pcContentEnablers
);
Parameters
-
rgpbCerts [in]
-
Array of certificates to retrieve content enablers for. The number of elements in the array must be specified by cCerts.
-
rgpdwCertSizes [in]
-
Array containing the sizes of the certificates in the rgpbCerts array. The number of elements in the array must be specified by cCerts.
-
rgpguidCerts [in]
-
Array containing the types of the certificates in the rgpbCerts array. The number of elements in the array must be specified by cCerts. For each element of the array, use one of the following values.
GUID constant Description WMDRM_REVOCATIONTYPE_APP Specifies an application certificate. WMDRM_REVOCATIONTYPE_DEVICE Specifies a device certificate. WMDRM_REVOCATIONTYPE_CARDEA Specifies a Windows Media DRM for Network Devices certificate. -
cCerts [in]
-
Number of certificates to retrieve content enablers for. This is the number of elements in the rgpbCerts array, the rgpdwCertSizes array, and the rgpguidCerts 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 |
|---|---|
|
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 |
|
| Library |
|