IWMDRMLicenseQuery::QueryLicenseState メソッド
[このページに関連付けられている機能である Windows Media Format 11 SDK は、レガシ機能です。 これは、ソース リーダーとシンク ライターによって置き換えられます。 ソース リーダーとシンク ライターは、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、Windows Media Format 11 SDK ではなくソース リーダーとシンク ライターを使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]
QueryLicenseState メソッドは、1 つ以上の特定の権限のキー ID に適用されるライセンス情報をローカル ライセンス ストアに照会します。
構文
HRESULT QueryLicenseState(
[in] BSTR bstrKID,
[in] DWORD cActionsToQuery,
[in] BSTR rgbstrActionsToQuery[],
[out] DRM_LICENSE_STATE_DATA rgResultStateData[]
);
パラメーター
-
bstrKID [in]
-
クエリ対象のキー ID。 このキー ID に適用されるライセンスのみが評価されます。
-
cActionsToQuery [in]
-
クエリを実行するアクションの数。 この値は、 rgbstrActionsToQuery パラメーターと rgResultStateData パラメーターに渡される配列内の要素の数に設定する必要があります。
-
rgbstrActionsToQuery[] [in]
-
クエリを実行する 1 つ以上の権限の配列。 この配列には、 cActionsToQuery で指定された数の要素を含める必要があります。 各要素は、次のいずれかの定数に設定する必要があります。
定数 説明 g_wszWMDRM_LicenseState_Backup を含めて、ライセンスのバックアップと復元の権利に関する詳細を照会します。 g_wszWMDRM_LicenseState_CollaborativePlay 共同再生シナリオの一環として、ユーザーのグループとコンテンツを共有する権限の詳細を照会するために を含めます。 g_wszWMDRM_LicenseState_Copy コンテンツを外部デバイスまたはメディアにコピーする権限の詳細を照会するには、 を含めます。 g_wszWMDRM_LicenseState_CopyToCD を含めて、コンテンツを CD にコピーする権限に関する詳細を照会します。 g_wszWMDRM_LicenseState_CopyToNonSDMIDevice を含めて、セキュリティで保護されたデジタル メディア イニシアチブ (SDMI) をサポートしていないデバイスにコンテンツをコピーする権利の詳細を照会します。 g_wszWMDRM_LicenseState_CopyToSDMIDevice を含めて、SDMI をサポートするデバイスにコンテンツをコピーする権限の詳細を照会します。 g_wszWMDRM_LicenseState_CreateThumbnailImage コンテンツからサムネイル画像を作成する権限の詳細を照会するには、 を含めます。 g_wszWMDRM_LicenseState_Playback を含めて、コンテンツを再生する権利に関する詳細を照会します。 g_wszWMDRM_LicenseState_PlaylistBurn を含めて、プレイリストの一部として CD にコンテンツをコピーする権限の詳細を照会します。 -
rgResultStateData[] [out]
-
rgbstrActionsToQuery パラメーターの対応する要素の右側に適用されるライセンス状態情報を受け取る 1 つ以上のDRM_LICENSE_STATE_DATA構造体の配列。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
メソッドが成功しました。 |
解説
指定したキー ID に適用されるすべてのライセンスが検索され、評価されます。 結果が集計されるため、各 DRM_LICENSE_STATE_DATA 構造には複数のライセンスからの情報が含まれる場合があります。
要件
要件 | 値 |
---|---|
ヘッダー |
|
ライブラリ |
|