IOleLink::SetSourceDisplayName メソッド (oleidl.h)

[アーティクル]
03/01/2024

リンクソースの表示名を設定します。

構文

HRESULT SetSourceDisplayName(
  [in] LPCOLESTR pszStatusText
);

パラメーター

[in] pszStatusText

新しいリンクソースの表示名へのポインター。このパラメーターを NULL にすることはできません。

戻り値

このメソッドは、成功したS_OKを返します。

MkParseDisplayName の値もここで返される場合があります。

注釈

呼び出し元へのメモ

エンドユーザーがリンクのソースを変更したり、リンクを切断したりすると、コンテナーアプリケーションは IOleLink::SetSourceDisplayName を呼び出すことができます。これには、リンクオブジェクトが表示名からモニカーを作成する必要があることに注意してください。表示名を自分でモニカーに解析する場合、コンテナーは IOleLink::SetSourceDisplayName ではなく IOleLink::SetSourceMoniker を呼び出すことができます。

OleUIEditLinks 関数を使用して [リンク] ダイアログボックスを表示する場合は、IOleUILinkContainer インターフェイスを実装する必要があります。ダイアログボックスは、 IOleUILinkContainer::SetLinkSource と IOleUILinkContainer::CancelLink の実装を呼び出します。これらのメソッドの実装では、 IOleLink::SetSourceDisplayName を呼び出すことができます。

コンテナーアプリケーションが新しく指定されたリンクソースにすぐにバインドする場合は、代わりに MkParseDisplayName と IOleLink::SetSourceMoniker を呼び出し、解析操作のバインドコンテキストを使用して IOleLink::BindToSource を呼び出す必要があります。バインドコンテキストを再利用することで、それ以外の場合に発生する可能性があるオブジェクトの冗長な読み込みを回避できます。

実装者へのメモ

IOleLink::SetSourceDisplayName のコントラクトでは、リンクオブジェクトが表示名をモニカーに解析するタイミングは指定されません。解析は 、IOleLink::SetSourceDisplayName が返される前に行われる場合があります。または、リンクオブジェクトが表示名を格納し、リンクソースにバインドする必要がある場合にのみ解析できます。表示名の解析は、リンクソースへのバインドが必要になる可能性があるため、コストの高い操作になる可能性があることに注意してください。 指定された IOleLink::SetSourceDisplayName の実装では、表示名が解析され、解析操作で使用されるバインドコンテキストが解放されます。これにより、リンクソースサーバーが実行され、停止する可能性があります。

リンクオブジェクトが現在のリンクソースにバインドされている場合、 IOleLink::SetSourceDisplayName の実装によって接続が切断されます。

リンクオブジェクトがリンクソースにモニカーを格納して使用する方法の詳細については、「 IOleLink::SetSourceMoniker」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	oleidl.h