Share via

IWMDRMSecurity：：GetContentEnablersForRevocations 方法

  • 發行項

[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows 媒體格式 11 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

GetContentEnablersForRevocations方法會擷取內容啟用器介面，以根據撤銷的憑證啟用元件更新。

語法

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

參數

rgpbCerts [in]

要擷取內容啟用器的憑證陣列。 陣列中的元素數目必須由 cCerts指定。

rgpdwCertSizes [in]

陣列，其中包含 rgpbCerts 陣列中憑證的大小。 陣列中的元素數目必須由 cCerts指定。

rgpguidCerts [in]

陣列，其中包含 rgpbCerts 陣列中的憑證類型。 陣列中的元素數目必須由 cCerts指定。 針對陣列的每個元素，請使用下列其中一個值。

GUID 常數 描述
WMDRM_REVOCATIONTYPE_APP 指定應用程式憑證。
WMDRM_REVOCATIONTYPE_DEVICE 指定裝置憑證。
WMDRM_REVOCATIONTYPE_CARDEA 指定網路裝置憑證的 Windows 媒體 DRM。

cCerts [in]

要擷取內容啟用器的憑證數目。 這是 rgpbCerts 陣列、rgpdwCertSizes陣列和rgpguidCerts陣列中的元素數目。

hResultHint [in]

從因撤銷憑證而失敗之作業收到的傳回值。 如果您未呼叫 以回應失敗的方法呼叫，請將 設定為 S_OK。

prgContentEnablers [out]

陣列，接收新建立 之 IMFContentEnabler 介面的位址。 設定為 Null ，以取得 pcContentEnablers 參數中的內容啟用者數目。

pcContentEnablers [in， out]

prgContentEnablers陣列中的元素數目。 如果 prgContentEnablers 為 Null，此值會設定為輸出上所需的內容啟用程式數目。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。

備註

如果您使用 IMFContentEnabler 介面來更新撤銷的元件，您必須向使用者厘清程式。 必須進行這項厘清，因為更新程式會將資訊從用戶端電腦傳送至 Microsoft 網站。

當您呼叫 IMFContentEnabler：：AutomaticEnable時，內容啟用器會啟動預設瀏覽器，並在 Microsoft 網站上的更新服務位址。 識別撤銷之元件的唯一識別碼會傳送至更新服務。 接著，服務會將瀏覽器重新導向至網頁，讓使用者可以從該網頁下載並安裝新版本的已撤銷元件。

規格需求

需求 值
標頭
Wmdrmsdk.h
程式庫
Wmdrmsdk.lib

另請參閱

自動化元件撤銷和更新

IWMDRMSecurity 介面