IResolveShellLink::ResolveShellLink 方法 (shobjidl_core.h)

要求資料夾物件解析殼層連結。

語法

HRESULT ResolveShellLink(
  [in] IUnknown *punkLink,
  [in] HWND     hwnd,
  [in] DWORD    fFlags
);

參數

[in] punkLink

類型: IUnknown*

物件的 IShellLink 介面指標。 接著,您可以查詢此介面來判斷連結的內容。

[in] hwnd

類型: HWND

Shell 用來做為對話方塊父系之視窗的控制碼。 如果殼層需要提示使用者在解析連結時提供詳細資訊,則會顯示對話方塊。

[in] fFlags

類型: DWORD

動作旗標。 此參數可以是下列值的組合。

SLR_INVOKE_MSI

呼叫 Windows Installer。

SLR_NOLINKINFO

停用分散式連結追蹤。 根據預設,分散式連結追蹤會根據磁片區名稱,追蹤跨多個裝置的卸載式媒體。 它也會使用 UNC 路徑來追蹤磁碟機號已變更的遠端檔案系統。 設定 SLR_NOLINKINFO 會停用這兩種類型的追蹤。

SLR_NO_UI

如果無法解析連結,請勿顯示對話方塊。 設定 SLR_NO_UI 時, fFlags 的高序單字會以毫秒為單位指定逾時持續時間。 如果連結無法在逾時期間內解析,則函式會傳回 。 如果高序單字設定為零,逾時持續時間會預設為 3000 毫秒, (3 秒) 。

SLR_NOUPDATE

請勿更新連結資訊。

SLR_NOSEARCH

請勿執行搜尋啟發學習法。

SLR_NOTRACK

請勿使用分散式連結追蹤。

SLR_UPDATE

如果連結化物件已變更,請更新其路徑和識別碼清單。 如果 已設定SLR_UPDATE ,您就不需要呼叫 IPersistFile::IsDirty 來判斷連結化物件是否已變更。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

這個方法應該嘗試尋找殼層連結的目標,即使目標已移動或重新命名也一樣。

規格需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
Dll Shell32.dll (5.0 版或更新版本)

另請參閱

IResolveShellLink