DRMCreateEnablingPrincipal 函数 (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.] 中公开的功能。

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

另请参阅

AD RMS 函数