IClassFactory2：：RequestLicKey 方法 (ocidl.h)

  • 项目

创建一个许可证密钥，调用方可以保存该密钥，稍后使用该密钥来创建许可对象的实例。

语法

HRESULT RequestLicKey(
  [in]  DWORD dwReserved,
  [out] BSTR  *pBstrKey
);

参数

[in] dwReserved

此参数是保留的，必须为零。

[out] pBstrKey

指向调用方分配的变量的指针，该变量在此方法成功返回时接收被调用方分配的许可证密钥。 任何失败时，此参数都设置为 NULL 。

返回值

此方法可以返回标准返回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及以下值。

返回代码 说明
S_OK
 已成功创建许可证密钥。
E_NOTIMPL
 此类工厂不支持运行时许可证密钥。
E_POINTER
 在 pbstrKey 中传递的地址无效。 例如，它可能为 NULL。
CLASS_E_NOTLICENSED
 此类工厂支持运行时许可，但当前计算机本身未获得许可。 因此，运行时密钥在此计算机上不可用。

注解

调用方可以保存许可证密钥，以便后续调用 IClassFactory2：：CreateInstanceLic ，以便在未授权的计算机上创建对象。

调用方备注

当不再需要密钥时，调用方必须使用 SysFreeString 函数释放 BSTR。 fRuntimeKeyAvail 的值是通过上一次调用 IClassFactory2：：GetLicInfo 返回的。

实施者说明

此方法使用 SysAllocString 或 SysAllocStringLen 分配 BSTR 键，此方法成功返回后，调用方将负责此 BSTR。

当类工厂不支持运行时许可证密钥时，不需要实现此方法。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IClassFactory2