Fungsi PathIsSystemFolderW (shlwapi.h)

Artikel
20/11/2024

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

Sintaksis

C++

BOOL PathIsSystemFolderW(
  [in, optional] LPCWSTR 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 nonzero. Jika nilai ini NULL, fungsi ini menentukan apakah atribut yang diteruskan dwAttrb memenuhi syarat menjadi folder sistem.

[in] dwAttrb

Jenis: DWORD

Atribut file yang akan dibandingkan. Digunakan hanya jika pszPath 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.

Mengembalikan nilai

Jenis: BOOL

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

Komentar

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

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

Bagikan melalui