IMDSPStorage：：GetRights 方法 (mswmdm.h)

GetRights 方法检索对象的权限信息。

语法

HRESULT GetRights(
  [out]     PWMDMRIGHTS *ppRights,
  [out]     UINT        *pnRightsCount,
  [in, out] BYTE [8]    abMac
);

[out] ppRights

指向包含存储对象权限信息的 WMDMRIGHTS 结构数组的指针。此参数包含在输出消息身份验证代码中。

[out] pnRightsCount

指向 ppRights 数组中 WMDMRIGHTS 结构数的指针。此参数包含在输出消息身份验证代码中。

[in, out] abMac

包含此方法的参数数据的消息身份验证代码的 8 个字节的数组。 (WMDM_MAC_LENGTH 定义为 8.)

该方法返回 HRESULT。 Windows Media 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

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

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

ppRights 数组由此方法分配，必须由应用程序使用 CoTaskMemFree（一个标准 Win32 函数）释放。

此方法是可选的。有关详细信息，请参阅必需接口和可选接口。