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

DRMCreateLicenseStorageSession 函数创建获取或操作许可证所需的许可证存储会话。

语法

DRMEXPORT HRESULT UDAPICALL DRMCreateLicenseStorageSession(
  [in]  DRMENVHANDLE hEnv,
  [in]  DRMHANDLE    hDefaultLibrary,
  [in]  DRMHSESSION  hClient,
  [in]  UINT         uFlags,
  [in]  PWSTR        wszIssuanceLicense,
  [out] DRMHSESSION  *phLicenseStorage
);

参数

[in] hEnv

AD RMS 环境的句柄。 此句柄是使用 DRMInitEnvironment 函数获取的。

[in] hDefaultLibrary

默认库的句柄。 此句柄是使用 DRMInitEnvironment 函数获取的。

[in] hClient

客户端会话的句柄。 此句柄是使用 DRMCreateClientSession 函数获取的。

[in] uFlags

此参数是保留的,必须设置为零。

[in] wszIssuanceLicense

指向包含已签名颁发许可证的以 null 结尾的 Unicode 字符串的指针。 创建的许可证存储会话与此颁发许可证相关联。

[out] phLicenseStorage

指向接收许可证存储会话句柄的句柄的指针。 当不再需要许可证存储会话时,必须将此句柄传递给 DRMCloseSession 函数。

返回值

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

如果函数失败,它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

注解

许可证存储会话用于获取、删除和枚举许可证,以及其他用途。 若要实际绑定到许可证并行使其权限,应用程序必须使用 DRMCreateBoundLicense

环境句柄和默认库句柄是使用 DRMInitEnvironment 创建的。

不再需要许可证存储会话时,必须将 phLicenseStorage 参数中返回的句柄传递给 DRMCloseSession 函数。

要求

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

另请参阅

AD RMS 函数

DRMCloseHandle

DRMCreateClientSession

DRMInitEnvironment

Decryption_GetBoundLicense.cpp