ホーム › Media.WindowsMediaFormat › IWMLicenseBackup
IWMLicenseBackup
COM公式ドキュメント
IWMLicenseBackup インターフェイスは、ライセンスのバックアップを管理します。通常は、別のコンピューターにライセンスを復元できるようにするために使用します。このインターフェイスは、WMCreateBackupRestorer 関数を使用して取得します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT BackupLicenses(DWORD dwFlags, IWMStatusCallback* pCallback)
BackupLicenses メソッドは、ライセンスのコピーを保存します。
| dwFlags | DWORD | in | フラグを格納する DWORD。
| ||||
| pCallback | IWMStatusCallback* | in | IWMStatusCallback インターフェイスを実装するオブジェクトへのポインター。 |
戻り値
このメソッドは HRESULT を返します。有効な値には次の表の値が含まれますが、これらに限定されません。
| リターンコード | 説明 |
|---|---|
| メソッドは成功しました。 | |
| pCallback パラメーターが NULL です。 | |
| タスクを実行するために使用できるメモリが不足しています。 |
解説(Remarks)
バックアップファイルの場所を指定する方法の詳細(この目的のために、バックアップパスと復元パスの定義済みプロパティがあります)については、IWMBackupRestoreProps インターフェイスを参照してください。
このメソッドは非同期に動作し、IWMStatusCallback オブジェクトを使用して進行状況を追跡できます。
vtbl 4 HRESULT CancelLicenseBackup()
CancelLicenseBackup メソッドは、現在のバックアップ操作をキャンセルします。
戻り値
メソッドが成功した場合は S_OK を返します。失敗した場合は HRESULT エラーコードを返します。
解説(Remarks)
バックアップ操作は非同期であり、このメソッドを呼び出すと、進行中のバックアップがキャンセルされます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IWMLicenseBackup "{05E5AC9F-3FB6-4508-BB43-A4067BA1EBE8}"
#usecom global IWMLicenseBackup IID_IWMLicenseBackup "{}"
#comfunc global IWMLicenseBackup_BackupLicenses 3 int,sptr
#comfunc global IWMLicenseBackup_CancelLicenseBackup 4
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。