次の方法で共有

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

こちらもご覧ください

IClassFactory2