IWMDRMLicenseManagement::RestoreLicenses メソッド

[このページに関連付けられている機能である Windows Media Format 11 SDK は、レガシ機能です。 これは、ソース リーダーとシンク ライターによって置き換えられます。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。

解説

このメソッドは非同期的に実行されます。 呼び出された直後に が返され、処理が完了したときに MEWMDRMLicenseRestoreProgress イベントの後に MEWMDRMLicenseRestoreCompleted イベントが生成されます 。 IMFMediaEvent::GetValue を呼び出して取得した各 MEWMDRMLicenseRestoreProgress イベントの値は、IUnknown ポインターです。 取得した IUnknown インターフェイスの QueryInterface メソッドを呼び出して、IWMDRMLicenseBackupRestoreStatus インターフェイスのインスタンスを取得できます。

Windows Media DRM クライアント拡張 API の非同期メソッドの使用の詳細については、「 Media Foundation イベント モデルの使用」を参照してください。

バックアップは、ローカル コンピューターまたは別のコンピューターから行うことができます。

要件

要件	値
ヘッダー	Wmdrmsdk.h
ライブラリ	Wmdrmsdk.lib

関連項目

IWMDRMLicenseManagement インターフェイス