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

リンク オブジェクトのリンク ソースを識別するモニカーを取得します。

構文

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

パラメーター

[out] ppmk

リンク ソースを識別する絶対モニカーへのインターフェイス ポインターを受け取る IMoniker ポインター変数のアドレス。 成功した場合、実装では ppmk で AddRef を呼び出す必要があります。Release を呼び出すのは呼び出し元の責任です。 エラーが発生した場合、実装では ppmk を NULL に設定する必要があります。

戻り値

このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。

リターン コード	説明
MK_E_UNAVAILABLE	モニカーは使用できません。

解説

呼び出し元へのメモ

コンテナー アプリケーションは IOleLink::GetSourceMoniker を呼び出して、[ リンク ] ダイアログ ボックスにリンクの現在のソースを表示できます。 そのためには、コンテナーで IMoniker::GetDisplayName メソッドを使用してモニカーの表示名を取得する必要があることに注意してください。 表示名を直接取得する場合、コンテナーは IOleLink::GetSourceMoniker ではなく IOleLink::GetSourceDisplayName を呼び出すことができます。

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

実装者へのメモ

リンク オブジェクトには、リンク ソースの絶対モニカーと相対モニカーの両方が格納されます。 相対モニカーが NULL 以外で、複合ドキュメントでモニカーを使用できる場合、 IOleLink::GetSourceMoniker は、複合ドキュメントのモニカーの末尾に相対モニカーを作成することによって作成されたモニカーを返します。 それ以外の場合は、絶対モニカーを返すか、エラーが発生した場合は NULL を返します。

コンテナーは、 OleCreateLink 関数のいずれかを呼び出してリンクを作成するときに、絶対モニカーを指定します。 アプリケーションは IOleLink::GetSourceMoniker または IOleLink::GetSourceDisplayName を呼び出して、絶対モニカーを変更できます。 さらに、リンク オブジェクトは、リンク ソースに正常にバインドされたとき、またはリンク ソースにバインドされ、 IAdviseSink::OnRename メソッドを介して名前変更通知を受け取ると、モニカーを自動的に更新します。

要件

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

関連項目

IOleLink

IOleLink::GetSourceDisplayName

IOleLink::GetSourceMoniker