PathIsSystemFolderA 函式 (shlwapi.h)

判斷現有資料夾是否包含使其成為系統資料夾的屬性。 或者，此函式會指出某些屬性是否限定資料夾為系統資料夾。

語法

BOOL PathIsSystemFolderA(
  [in, optional] LPCSTR pszPath,
  [in]           DWORD  dwAttrb
);

參數

[in, optional] pszPath

類型： LPCTSTR

包含現有資料夾名稱之 null 終止字串的指標，長度上限為 MAX_PATH。 系統會擷取此資料夾的屬性，並與定義系統資料夾的屬性進行比較。 如果此資料夾包含屬性，使其成為系統資料夾，則函式會傳回非零。 如果此值為 NULL，此函式會判斷 在 dwAttrb 中傳遞的屬性是否限定為系統資料夾。

[in] dwAttrb

類型： DWORD

要比較的檔案屬性。 只有在 pszPath 為 NULL 時才使用。 在此情況下，傳入此值的屬性會與將資料夾限定為系統資料夾的屬性進行比較。 如果屬性足以將此設為系統資料夾，則此函式會傳回非零。 這些屬性是從 GetFileAttributes 傳回的屬性。

傳回值

類型： BOOL

如果 pszPath 或 dwAttrb 代表系統資料夾，則傳回非零，否則傳回零。

備註

注意

shlwapi.h 標頭會將PathIsSystemFolder定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或Unicode版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shlwapi.h
程式庫	Shlwapi.lib
Dll	Shlwapi.dll (4.71 版或更新版本)