Share via


IKnownFolderManager::FindFolderFromPath 方法 (shobjidl_core.h)

取得物件,表示以文件系統路徑為基礎的已知資料夾。 物件可讓您查詢特定資料夾屬性、取得資料夾的目前路徑、將資料夾重新導向至另一個位置,以及取得資料夾的路徑做為 ITEMIDLIST

語法

HRESULT FindFolderFromPath(
  [in]  LPCWSTR      pszPath,
  [in]  FFFP_MODE    mode,
  [out] IKnownFolder **ppkf
);

參數

[in] pszPath

類型: LPCWSTR

長度為 null 的 Unicode 字串指標,其長度為 MAX_PATH,其中包含已知資料夾的路徑。

[in] mode

類型: FFFP_MODE

下列其中一個值,指定路徑和已知資料夾相符項目的精確度:

FFFP_EXACTMATCH

只擷取指定檔案路徑的特定已知資料夾。

FFFP_NEARESTPARENTMATCH

如果找不到指定檔案路徑的完全相符專案,請擷取符合其其中一個父資料夾的第一個已知資料夾,其會向上瀏覽父樹狀結構。

[out] ppkf

類型: IKnownFolder**

當這個方法傳回時,會包含代表已知資料夾之 IKnownFolder 物件的指標位址。

傳回值

類型: HRESULT

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

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
Dll Shell32.dll

另請參閱

IKnownFolderManager

已知資料夾範例