Fungsi SaferiIsExecutableFileType (winsafer.h)

Fungsi SaferiIsExecutableFileType menentukan apakah file tertentu adalah file yang dapat dieksekusi. Aplikasi menggunakan fungsi ini untuk menentukan apakah file adalah file yang dapat dieksekusi, dan jika ya, aplikasi dapat mengambil tindakan pencegahan keamanan untuk mencegah pemanggilan kode yang tidak dapat dipercaya.

Sintaks

BOOL SaferiIsExecutableFileType(
  [in] LPCWSTR szFullPathname,
  [in] BOOLEAN bFromShellExecute
);

Parameter

[in] szFullPathname

Penunjuk ke string karakter Unicode yang dihentikan null untuk nama file. Jalur bersifat opsional karena hanya ekstensi nama file yang dievaluasi. Evaluasi ekstensi nama file tidak peka huruf besar/kecil. Parameter ini tidak boleh NULL atau string kosong, dan file yang ditentukan harus menyertakan ekstensi nama file.

[in] bFromShellExecute

Nilai Boolean yang menentukan apakah file .exe diperlakukan sebagai file yang dapat dieksekusi untuk evaluasi jenis file. Atur nilai ini ke TRUE untuk menghilangkan file .exe dari evaluasi atau ke FALSE untuk menyertakannya.

Mengembalikan nilai

Jika fungsi berhasil mengenali ekstensi nama file sebagai jenis file yang dapat dieksekusi, nilai yang dikembalikan adalah TRUE.

Jika fungsi gagal, atau jika szFullPath mengidentifikasi nama file dengan ekstensi yang tidak dapat dikurangi, fungsi mengembalikan FALSE.

Keterangan

Ekstensi nama file berikut adalah contoh jenis file yang dapat dieksekusi. Ini bukan daftar lengkap.

  • .bat
  • .cmd
  • .com
  • .exe
  • .js
  • .Lnk
  • .pif
  • .Pl
  • .Shs
  • .Url
  • .Vbs
Kebijakan keamanan snap-in Microsoft Management Console (MMC) (Secpol.msc) mengontrol ekstensi mana yang dianggap sebagai jenis file yang dapat dieksekusi.

Untuk melihat atau mengubah ekstensi yang dianggap sebagai jenis file yang dapat dieksekusi

  1. Jalankan Secpol.msc.
  2. Perluas Kebijakan Pembatasan Perangkat Lunak, lalu klik dua kali Jenis File yang Ditunjuk.
Catatan Untuk melihat halaman properti Jenis File yang Ditunjuk , Anda mungkin perlu membuat simpul Kebijakan Pembatasan Perangkat Lunak . Untuk membuat simpul Kebijakan Pembatasan Perangkat Lunak , ikuti instruksi yang muncul saat Anda memperluas Kebijakan Pembatasan Perangkat Lunak.
 

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header winsafer.h
Pustaka Advapi32.lib
DLL Advapi32.dll
Set API ext-ms-win-advapi32-safer-l1-1-0 (diperkenalkan dalam Windows 8)