DRMAddRightWithUser 函数 (msdrm.h)

[利用由 公开的功能的 AD RMS SDK

Msdrm.dll 中的客户端可用于 Windows Server 2008、Windows Vista、Windows Server 2008 R2、Windows 7、Windows Server 2012 和 Windows 8。 它可能被更改,或者

在后续版本中不可用。 请改用 Active Directory Rights Management Services SDK 2.1

利用客户端在 Msipc.dll.] 中公开的功能。

DRMAddRightWithUser 函数将权限分配给颁发许可证中的用户。

语法

DRMEXPORT HRESULT UDAPICALL DRMAddRightWithUser(
  [in] DRMPUBHANDLE hIssuanceLicense,
  [in] DRMPUBHANDLE hRight,
  [in] DRMPUBHANDLE hUser
);

参数

[in] hIssuanceLicense

要向其添加权限的颁发许可证的句柄。 此句柄是使用 DRMCreateIssuanceLicense 函数获取的。

[in] hRight

要添加到颁发许可证中的权利的句柄。 此句柄是使用 DRMCreateRight 函数获取的。

[in] hUser

要应用权限的用户的句柄。 此句柄是使用 DRMCreateUser 函数获取的。

返回值

如果函数成功,该函数将返回S_OK。

如果函数失败,它将返回指示错误的 HRESULT 值。 可能的值包括但不限于以下列表中的值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

注解

由于无法删除特定用户权限 (删除所有用户权限,因此请使用 DRMClearAllRights 函数) ,建议先收集所有用户和权限信息,然后在进行所有更改后将用户绑定到权限。

添加的所有权限必须由应用程序专门识别和处理。 应用程序不需要处理除 EDIT 之外的任何标准 XrML 权限。 例如,如果允许用户以任何方式编辑内容, (向用户授予自定义“ADDCOMMENT”权限) ,则还必须向用户授予标准 XrML EDIT 权限。

要求

要求
目标平台 Windows
标头 msdrm.h
Library Msdrm.lib
DLL Msdrm.dll

另请参阅

AD RMS 函数

创建和使用颁发许可证

DRMCreateIssuanceLicense

DRMCreateRight

DRMCreateUser