[利用由 公开的功能的 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 |