COleClientItem::SetHostNames

[アーティクル]
08/09/2011

コンテナーアプリケーションの名前と、埋め込みオブジェクトを持つコンテナーの名前を指定します。

void SetHostNames(
   LPCTSTR lpszHost,
   LPCTSTR lpszHostObj 
);

パラメーター

lpszHost
ユーザーが判読できるコンテナーアプリケーション名へのポインター。
lpszHostObj
OLE アイテムを保持するコンテナーの識別文字列へのポインター。

解説

サーバーアプリケーションが MFC ライブラリを使って記述されていると、この関数は OLE アイテムを保持する COleServerDoc ドキュメントの OnSetHostNames メンバー関数を呼び出します。この情報は、OLE アイテムを編集するときに、ウィンドウのタイトルとして使われます。コンテナードキュメントが読み込まれるたびに、フレームワークはドキュメント内のすべての OLE アイテムに対してこの関数を呼び出します。 SetHostNames 関数は、埋め込みアイテムのみに適用されます。 OLE 埋め込みアイテムが編集のためにアクティブになるたびに、この関数を呼び出す必要はありません。

また、この関数はオブジェクトが読み込まれたとき、またはファイルが異なる名前で保存されたときに、アプリケーション名とドキュメント名が指定されて自動的に呼び出されます。そのため、通常この関数を直接呼び出す必要はありません。

詳細については、Windows SDK の「IOleObject::SetHostNames」を参照してください。