IClassFactory2::RequestLicKey メソッド (ocidl.h)

呼び出し元が後でライセンスオブジェクトのインスタンスを作成するために保存して使用できるライセンスキーを作成します。

構文

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

[in] dwReserved

このパラメーターは予約されており、0 である必要があります。

[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