IWMDRMLicenseManagement：：RestoreLicenses 方法
[與此頁面相關聯的功能 Windows Media Format 11 SDK是舊版功能。 來源讀取器和接收寫入器已取代它。 來源讀取器和接收寫入器已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用來源讀取器和接收寫入器，而不是Windows Media Format 11 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]
RestoreLicenses方法會從呼叫BackupLicenses方法所建立的授權備份還原授權。
語法
HRESULT RestoreLicenses(
[in] BSTR bstrBackupDirectory,
[in] DWORD dwFlags,
[out] IUnknown **ppunkCancelationCookie
);
參數
-
bstrBackupDirectory [in]
-
將還原授權所在位置的 UNC 路徑。
-
dwFlags [in]
-
指定要使用之還原選項的旗標。 目前唯一支援的旗標是WMDRM_RESTORE_INDIVIDUALIZE，它會視需要將方法設定為在還原過程中執行個別化。
-
ppunkCancelationCookie [out]
-
接收物件 之 IUnknown 介面指標的指標，可識別這個非同步呼叫。 這個介面指標可用來藉由呼叫 IWMDRMEventGenerator：：CancelAsyncOperation 方法來取消非同步呼叫。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
備註
這個方法會以非同步方式執行。 它會在呼叫之後立即傳回，然後在處理完成時產生一系列 MEWMDRMLicenseRestoreProgress 事件，後面接著 MEWMDRMLicenseRestoreCompleted 事件。 呼叫IMFMediaEvent：：GetValue取得的每個MEWMDRMLicenseRestoreProgress事件值都是IUnknown指標。 您可以呼叫所擷取之 IUnknown介面的QueryInterface方法，以取得IWMDRMLicenseBackupRestoreStatus介面的實例。
如需使用 Windows Media DRM 用戶端擴充 API 非同步方法的詳細資訊，請參閱 使用媒體基礎事件模型。
備份可以是來自本機電腦或來自不同電腦的備份。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 |
|
| 程式庫 |
|