IOleLink::SetSourceDisplayName メソッド (oleidl.h)
リンク ソースの表示名を設定します。
構文
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 |