Fungsi PathIsSystemFolderA (shlwapi.h)

Artikel
03/13/2024

Menentukan apakah folder yang ada berisi atribut yang menjadikannya folder sistem. Secara bergantian, fungsi ini menunjukkan apakah atribut tertentu memenuhi syarat folder menjadi folder sistem.

Sintaks

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

Parameter

[in, optional] pszPath

Jenis: LPCTSTR

Penunjuk ke string panjang maksimum yang dihentikan null MAX_PATH yang berisi nama folder yang ada. Atribut untuk folder ini akan diambil dan dibandingkan dengan atribut yang menentukan folder sistem. Jika folder ini berisi atribut untuk menjadikannya folder sistem, fungsi mengembalikan bukan nol. Jika nilai ini NULL, fungsi ini menentukan apakah atribut yang diteruskan dalam dwAttrb memenuhi syarat untuk menjadi folder sistem.

[in] dwAttrb

Jenis: DWORD

Atribut file yang akan dibandingkan. Digunakan hanya jika pszPath ADALAH NULL. Dalam hal ini, atribut yang diteruskan dalam nilai ini dibandingkan dengan atribut yang memenuhi syarat folder sebagai folder sistem. Jika atribut cukup untuk menjadikan ini folder sistem, fungsi ini mengembalikan nonzero. Atribut ini adalah atribut yang dikembalikan dari GetFileAttributes.

Nilai kembali

Jenis: BOOL

Mengembalikan bukan nol jika pszPath atau dwAttrb mewakili folder sistem, atau nol sebaliknya.

Keterangan

Catatan

Header shlwapi.h mendefinisikan PathIsSystemFolder sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)

Bagikan melalui