IShellLinkA：：GetPath 方法 (shobjidl_core.h)

發行項
03/02/2024

取得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 版或更新版本)

共用方式為