IWMDRMLicenseManagement::BackupLicenses メソッド

[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーとシンク ライターに置き換わりました。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]

BackupLicenses メソッドは、ローカル ライセンス ストアにライセンスのバックアップを作成します。

構文

HRESULT BackupLicenses(
  [in]  BSTR     bstrBackupDirectory,
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

パラメーター

bstrBackupDirectory [in]

ライセンスのバックアップ先となる場所の UNC パス。

dwFlags [in]

使用するバックアップ オプションを指定するフラグ。 現在サポートされている唯一のフラグは WMDRM_BACKUP_OVERWRITE です。これにより、ディレクトリ内の既存のバックアップ ファイルを上書きするように メソッドが構成されます。

ppunkCancelationCookie [out]

この非同期呼び出しを識別するオブジェクトの IUnknown インターフェイスへのポインターを受け取るポインター。 このインターフェイス ポインターを使用すると、 IWMDRMEventGenerator::CancelAsyncOperation メソッドを呼び出して非同期呼び出しを取り消すことができます。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

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

解説

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

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

すべてのライセンスのバックアップが許可されているわけではありません。 この方法では、それを許可するライセンスのみがバックアップされます。

要件

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

関連項目

IWMDRMLicenseManagement インターフェイス