共用方式為


IShellLinkA::GetPath 方法 (shobjidl_core.h)

取得Shell連結物件目標的路徑和檔名。

語法

HRESULT GetPath(
  [out]     LPSTR            pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAA *pfd,
  [in]      DWORD            fFlags
);

參數

[out] pszFile

類型: LPTSTR

緩衝區的位址,該緩衝區會接收Shell連結物件之目標的路徑和檔名。

[in] cch

類型: int

pszFile 參數所指向之緩衝區的大小,以字元為單位,包括終止的 Null 字元。 可傳回的路徑大小上限為 MAX_PATH。 這個參數通常是藉由呼叫ARRAYSIZE (pszFile) 來設定。 ARRAYSIZE 宏定義於 Winnt.h 中。

[in, out] pfd

類型: WIN32_FIND_DATA*

WIN32_FIND_DATA 結構的指標 ,可接收殼層連結物件之目標的相關信息。 如果此參數為 NULL,則不會傳回其他資訊。

[in] fFlags

類型: DWORD

指定要擷取之路徑資訊類型的旗標。 此參數可以是下列值的組合。

SLGP_SHORTPATH

擷取標準簡短 (8.3 格式) 檔名。

SLGP_UNCPRIORITY

支援;請勿使用。

SLGP_RAWPATH

擷取原始路徑名稱。 原始路徑可能不存在,而且可能包含需要展開的環境變數。

SLGP_RELATIVEPRIORITY

Windows Vista 和更新版本。 盡可能擷取快捷方式目標的路徑,相對於先前呼叫 IShellLink::SetRelativePath 所設定的路徑。

傳回值

類型: HRESULT

如果作業成功且擷取有效的路徑,則傳回 S_OK 。 如果作業成功但未擷取路徑,則會傳回 S_FALSE而且 pszFile 會是空的。 否則,它會傳回其中一個標準 HRESULT 錯誤值。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h
Dll Shell32.dll (4.0 版或更新版本)