[利用由 公开的功能的 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.] 中公开的功能。
DRMCreateEnablingPrincipal 函数创建绑定到许可证所需的启用主体。
语法
DRMEXPORT HRESULT UDAPICALL DRMCreateEnablingPrincipal(
[in] DRMENVHANDLE hEnv,
[in] DRMHANDLE hLibrary,
[in] PWSTR wszObject,
[in] DRMID *pidPrincipal,
[in] PWSTR wszCredentials,
[out] DRMHANDLE *phEnablingPrincipal
);
parameters
[in] hEnv
DRMInitEnvironment 创建的环境的句柄。
[in] hLibrary
库的句柄。 目前,唯一可以使用的有效库是由 DRMInitEnvironment 传递的库。
[in] wszObject
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定启用主体类型。 应用程序可以使用 Msdrmgetinfo.h 中指定的对象常量。
[in] pidPrincipal
指向标识启用主体的 DRMID 结构的指针。 DRMID 成员可以为 NULL,以使用许可证中的第一个主体。
[in] wszCredentials
指向以 null 结尾的 Unicode 字符串的指针,该字符串包含当前用户 的权限帐户证书 。
[out] phEnablingPrincipal
指向接收已创建主体的 DRMHANDLE 值的指针。 调用 DRMCloseHandle 以关闭句柄。
返回值
如果函数成功,该函数将返回S_OK。
如果函数失败,它将返回指示错误的 HRESULT 值。 可能的值包括但不限于以下列表中的值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值。
注解
此函数创建的启用主体用于传入 DRMCreateBoundLicense 的 DRMBOUNDLICENSEPARAMS 结构中。 调用 DRMCloseHandle 以关闭通过调用此函数创建的启用主体句柄。
要求
| 目标平台 | Windows |
| 标头 | msdrm.h |
| Library | Msdrm.lib |
| DLL | Msdrm.dll |