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 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

有关可能错误代码的广泛列表，请参阅错误代码。

对象权限描述数字媒体内容的使用权限。例如， WMDMRIGHTS 结构可以包含有关文件可以播放多少次以及谁可以播放它的信息。

从许可文件检索权限有时可能是一个冗长的请求;此函数允许异步执行权限请求。

除了进度通知之外，安全内容提供程序还可以在回调 pIProgressCallback 上生成事件通知。此类事件的示例包括获取安全时钟、初始化 DRM 等。 IWMDMProgress3：:P rogress3 中介绍了这些事件。

此方法与 IWMDMStorage：：GetRights 相同，只不过它返回进度，并且不提供用于参数验证的 MAC。