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

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

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

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

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

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

IMDSPStorage 接口

WMDMRIGHTS