IWMDRMLicenseQuery：：QueryLicenseState 方法

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

QueryLicenseState 方法查询本地许可证存储，以获取适用于一个或多个特定权限的密钥 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]

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

一个或多个 DRM_LICENSE_STATE_DATA 结构的数组，这些结构接收许可证状态信息，该信息适用于 rgbstrActionsToQuery 参数的相应元素中的右侧。

返回值

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

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

备注

将搜索和评估应用于指定密钥 ID 的所有许可证。 结果是聚合的，因此每个 DRM_LICENSE_STATE_DATA 结构可能包含来自多个许可证的信息。

要求

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

另请参阅

IWMDRMLicenseQuery 接口