IWMDRMLicenseQuery::QueryActionAllowed メソッド
[このページに関連付けられている機能である Windows Media Format 11 SDK は、従来の機能です。 ソース リーダーとシンク ライターに置き換わりました。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 Microsoft では、可能であれば、新しいコードで Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、レガシ API を使用する既存のコードを、可能であれば新しい API を使用するように書き換えるよう提案しています。]
QueryActionAllowed メソッドは、ローカル ライセンス ストアに対してクエリを実行して、指定されたキー ID に適用される 1 つ以上の DRM アクションのライセンス状態を取得します。
構文
HRESULT QueryActionAllowed(
[in] BSTR bstrKID,
[in] BSTR bstrMinReqIndivVersion,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DWORD rgdwQueryResult[]
);
パラメーター
-
bstrKID [in]
-
クエリを実行するキー ID。 このキー ID に適用されるライセンスのみが評価されます。
-
bstrMinReqIndivVersion [in]
-
ASF ファイルのヘッダーで指定された最小セキュリティ バージョン。 このパラメーターは省略可能です。 NULL を渡して、この情報なしでクエリを実行します。
-
cActionsToQuery [in]
-
クエリを実行するアクションの数。 この値は、 rgbstrActionsToQuery パラメーターと rgdwQueryResult パラメーターに渡される配列内の要素の数に設定する必要があります。
-
rgbstrActionsToQuery[] [in]
-
クエリを実行する 1 つ以上の権限の配列。 この配列には、 cActionsToQuery で指定された数の要素を含める必要があります。 各要素は、次のいずれかの定数に設定する必要があります。
定数 説明 g_wszWMDRM_ActionAllowed_Playback を含めて、コンテンツを再生する権限を照会します。 g_wszWMDRM_ActionAllowed_Copy 外部デバイスまたはメディアにコンテンツをコピーする権限を照会するには、 を含めます。 g_wszWMDRM_ActionAllowed_PlaylistBurn を含めて、プレイリストの一部として CD にコンテンツをコピーする権限を照会します。 g_wszWMDRM_ActionAllowed_CreateThumbnailImage を含めて、コンテンツからサムネイル 画像を作成する権限を照会します。 g_wszWMDRM_ActionAllowed_CopyToCD を含めて、CD にコンテンツをコピーする権限を照会します。 -
rgdwQueryResult[] [out]
-
rgbstrActionsToQuery で指定された権限に対するクエリの結果を受け取る 1 つ以上の DWORD 変数の配列。 アクションが許可されている場合、対応する要素は 0 に設定されます。 アクションが許可されていない場合、要素はビットごとの OR 演算を使用して結合 されたDRM_ACTION_ALLOWED_QUERY_RESULTS 列挙の 1 つ以上の値に設定されます。 この配列には、 cActionsToQuery で指定された数の要素を含める必要があります。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
解説
再生権限とコピー権限を照会する場合は、まず環境パラメーターを設定することで、より正確な結果が得られます。 環境パラメーターを設定するには 、SetActionAllowedQueryParams メソッドを使用します。 書き込み権限に対するクエリの結果は、環境パラメーターの影響を受けません。既定値を安全に使用できます。
QueryActionAllowed メソッドによって返される結果は、ローカル ライセンス ストア内の 0 個以上のライセンスから集計されます。 メソッドは、有効な結果が発生した場合、キー ID に適用されるすべてのライセンスを検索することはできません。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|