共用方式為

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