IWMDRMLicenseQuery：：QueryActionAllowed 方法

[与此页面关联的功能 Windows Media Format 11 SDK 是旧版功能。 它已被源读取器和接收器编写器取代。 源读取器和接收器编写器已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用源读取器和接收器编写器，而不是 Windows Media Format 11 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

QueryActionAllowed 方法对本地许可证存储区执行查询，以检索适用于指定密钥 ID 的一个或多个 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]

要查询的一个或多个权限的数组。 此数组必须包含 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]

一个或多个 DWORD 变量的数组，这些变量接收 rgbstrActionsToQuery 指定权限的查询结果。 如果允许某个操作，则相应的元素设置为零。 如果不允许操作，则元素设置为使用按位 OR 操作组合 的DRM_ACTION_ALLOWED_QUERY_RESULTS 枚举的一个或多个值。 此数组必须包含 cActionsToQuery 指定的任意数量的元素。

返回值

该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。

备注

查询播放和复制权限时，首先设置环境参数可以获得更准确的结果。 使用 SetActionAllowedQueryParams 方法设置环境参数。 对燃烧权的查询结果不受环境参数影响;可以安全地使用默认值。

QueryActionAllowed 方法返回的结果从本地许可证存储中的零个或多个许可证聚合。 如果方法遇到启用的结果，则该方法可能不会搜索应用于密钥 ID 的所有许可证。

要求

要求	值
标头	Wmdrmsdk.h
库	Wmdrmsdk.lib

另请参阅

IWMDRMLicenseQuery 接口

查询简单权限信息