IOleUILinkContainerA::SetLinkSource メソッド (oledlg.h)

リンクのソースを変更します。

構文

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR lpszDisplayName,
  [in]  ULONG lenFileName,
  [out] ULONG *pchEaten,
  [in]  BOOL  fValidateSource
);

パラメーター

[in] dwLink

単一リンクのコンテナー定義の一意識別子。 「IOleUILinkContainer::GetNextLink」を参照してください。

[in] lpszDisplayName

解析する新しいソース文字列へのポインター。

[in] lenFileName

lpszDisplayName 文字列の先頭のファイル名部分の長さ。 リンク ソースがファイルに格納されていない場合、 lenFileName は 0 である必要があります。 OLE リンクの場合は、 IOleLink::GetSourceDisplayName を呼び出します。

[out] pchEaten

lpszDisplayName で正常に解析された文字数へのポインター。

[in] fValidateSource

モニカ ーを検証する必要がある場合は TRUE。OLE リンクの場合は、 MkParseDisplayName を 呼び出す必要があります。 モニカ ーを検証しない場合は FALSE。 可能であれば、リンクは未検証のソースを受け入れ、それ自体を使用不可としてマークする必要があります。

戻り値

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

リターン コード	説明
E_ACCESSDENIED	アクセス許可が不十分です。
E_FAIL	操作が失敗しました。
E_INVALIDARG	指定された識別子が無効です。
E_OUTOFMEMORY	この操作で使用できるメモリが不足しています。

解説

呼び出し元へのメモ

fValidateSource を最初に TRUE に設定して、[ソースの変更] ダイアログ ボックスからこのメソッドを呼び出します。 ソースの変更 は、直接呼び出すか、[ リンク ] ダイアログ ボックスから呼び出すことができます。 この IOleUILinkContainer::SetLinkSource の呼び出しでエラーが返された場合 (たとえば、ソースが使用できなかったために MkParseDisplayName が失敗した場合)、無効なリンク ソース メッセージを表示し、ソースを修正するかどうかをユーザーが決定できるようにする必要があります。 ユーザーがソースの修正を選択した場合は、入力文字列の無効な部分が強調表示された [ ソースの変更 ] ダイアログ ボックスにユーザーが返されます。 ユーザーがソースを修正しないことを選択した場合は、fValidateSource を FALSE に設定して IOleUILinkContainer::SetLinkSource を 2 回目に呼び出し、リンクが [利用不可] とマークされた [リンク] ダイアログ ボックスにユーザーを返す必要があります。

要件

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

関連項目

IOleUILinkContainer

MkParseDisplayName