IOleLink::GetSourceMoniker メソッド (oleidl.h)
リンク オブジェクトのリンク ソースを識別するモニカーを取得します。
構文
HRESULT GetSourceMoniker(
[out] IMoniker **ppmk
);
パラメーター
[out] ppmk
リンク ソースを識別する絶対モニカーへのインターフェイス ポインターを受け取る IMoniker ポインター変数のアドレス。 成功した場合、実装では ppmk で AddRef を呼び出す必要があります。Release を呼び出すのは呼び出し元の責任です。 エラーが発生した場合、実装では ppmk を NULL に設定する必要があります。
戻り値
このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
モニカーは使用できません。 |
解説
呼び出し元へのメモ
コンテナー アプリケーションは 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 |