IWMDRMLicenseManagement::CleanLicenseStore メソッド

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

CleanLicenseStore メソッドは、一時的なライセンス ストアから使用できないライセンスを削除し、パフォーマンスを向上させるためにローカル ライセンス ストアを最適化します。

構文

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

パラメーター

dwFlags [in]

使用するライセンス ストアのクリーニング オプションを指定するフラグ。 次の表のいずれかの定数に設定します。

定数	説明
WMDRM_CLEAN_LICENSE_STORE_SYNC	クリーン操作は同期的に実行されます。 このメソッドは、操作が完了するまで戻りません。
WMDRM_CLEAN_LICENSE_STORE_ASYNC	クリーン操作は非同期的に実行されます。 このメソッドは直ちにを返します。 操作が完了すると、メディア イベント MELicenseStoreCleaned が送信されます。

ppunkCancelationCookie [out]

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

戻り値

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

リターン コード	説明
S_OK	メソッドが成功しました。
DRM_E_LICENSENOTFOUND	クライアント コンピューターに一時的なライセンス ストアはありません。

解説

このメソッドは非同期的に実行されます。 呼び出された直後に が返され、処理が完了すると MEWMDRMLicenseStoreCleaned イベントが生成されます。

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

要件

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

関連項目

IWMDRMLicenseManagement インターフェイス