IWMDRMSecurity::P erformSecurityUpdate 方法

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

PerformSecurityUpdate方法會在本機電腦上起始 DRM 子系統的安全性更新。

語法

HRESULT PerformSecurityUpdate(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

參數

dwFlags [in]

以下列其中一個旗標表示的更新選項。

旗標 描述
WMDRM_SECURITY_PERFORM_INDIV 只有在用戶端版本過期時,才會將 DRM 元件個別化。
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH 使用戶端電腦上的撤銷清單更新。
WMDRM_SECURITY_PERFORM_FORCE_INDIV 即使用戶端的版本是最新的,仍會導致 DRM 元件個別化。

ppunkCancelationCookie [out]

接收物件指標的變數位址,該物件可用來取消這項作業。

傳回值

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

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

備註

這個方法會以非同步方式執行。 它會在呼叫之後立即傳回,然後根據 dwFlags 參數中設定的旗標產生事件。

針對設定為WMDRM_SECURITY_PERFORM_INDIV或WMDRM_SECURITY_PERFORM_FORCE_INDIV) 的個別化 (旗標,會在處理完成時產生一系列的 MEWMDRMIndividualizationProgress 事件,後面接著 MEWMDRMIndividualizationCompleted 事件。 呼叫IMFMediaEvent::GetValue取得的每個MEWMDRMIndividualizationProgress事件值都是IUnknown指標。 您可以呼叫所擷取之 IUnknown介面的QueryInterface方法,以取得IWMDRMIndividualizationStatus介面的實例。

若要重新整理撤銷清單 (旗標設定為 WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH) ,處理完成時會產生 MEWMDRMREvocationDownloadCompleted 事件。

注意

當 PerformSecurityUpdate 完成個別化時,唯一會反映新個別化狀態的現有物件是繼承自 IWMDRMSecurity的物件。 所有其他現有的物件都不會更新。 您必須釋放並重新建立任何其他物件,使其反映新的個別化狀態。

如需使用 Windows Media DRM 用戶端擴充 API 非同步方法的詳細資訊,請參閱 使用媒體基礎事件模型。

規格需求

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

另請參閱

自動化元件撤銷和更新

DRM 個人化範例

IWMDRMSecurity 介面

執行 DRM 個人化