IWMDMStorage4::GetRightsWithProgress メソッド (mswmdm.h)
GetRightsWithProgress メソッドは、ストレージ オブジェクトの権限情報を取得し、進行状況を監視するためのコールバック メカニズムを提供します。
構文
HRESULT GetRightsWithProgress(
[in] IWMDMProgress3 *pIProgressCallback,
[out] PWMDMRIGHTS *ppRights,
[out] UINT *pnRightsCount
);
パラメーター
[in] pIProgressCallback
Windows Media デバイス マネージャーがアプリケーションに進行状況を報告するために使用する IWMDMProgress3 インターフェイスへのオプションのポインター。
[out] ppRights
ストレージ オブジェクト権限情報を含む WMDMRIGHTS 構造体の配列へのポインター。 この配列のメモリは、Windows Media デバイス マネージャーによって割り当てられます。 呼び出し元のアプリケーションがこの配列へのアクセスを完了したら、 CoTaskMemFree を使用してメモリを解放する必要があります。
[out] pnRightsCount
ppRights 配列内の WMDMRIGHTS 構造体の数へのポインター。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャーエラー コード
注釈
オブジェクト権限は、デジタル メディア コンテンツの使用権限を表します。 たとえば、 WMDMRIGHTS 構造体には、ファイルを再生できる回数と再生できるユーザーに関する情報を含めることができます。
ライセンスされたファイルから権限を取得すると、時間の長い要求になる場合があります。この関数を使用すると、権限要求を非同期的に実行できます。
セキュリティで保護されたコンテンツ プロバイダーは、進行状況通知に加えて、コールバック pIProgressCallback でイベント通知を生成できます。 このようなイベントの例としては、セキュリティで保護されたクロックの取得、DRM の初期化などがあります。 これらのイベントについては、 IWMDMProgress3::P rogress3 を参照してください。
このメソッドは IWMDMStorage::GetRights と同じですが、進行状況を返し、パラメーター検証用の MAC は提供しません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | mswmdm.h |
| Library | Mssachlp.lib |