Baca dalam bahasa Inggris

Bagikan melalui


Fungsi Process32FirstW (tlhelp32.h)

Mengambil informasi tentang proses pertama yang ditemui dalam rekam jepret sistem.

Sintaksis

BOOL Process32FirstW(
  [in]      HANDLE            hSnapshot,
  [in, out] LPPROCESSENTRY32W lppe
);

Parameter

[in] hSnapshot

Handel ke rekam jepret yang dikembalikan dari panggilan sebelumnya ke fungsi CreateToolhelp32Snapshot.

[in, out] lppe

Penunjuk ke struktur PROCESSENTRY32W. Ini berisi informasi proses seperti nama file yang dapat dieksekusi, pengidentifikasi proses, dan pengidentifikasi proses proses induk.

Mengembalikan nilai

Mengembalikan TRUE jika entri pertama daftar proses telah disalin ke buffer atau FALSE sebaliknya. Nilai kesalahan ERROR_NO_MORE_FILES dikembalikan oleh fungsi GetLastError jika tidak ada proses atau rekam jepret tidak berisi informasi proses.

Komentar

Aplikasi panggilan harus mengatur dwSize anggota PROCESSENTRY32W ke ukuran, dalam byte, dari struktur.

Untuk mengambil informasi tentang proses lain yang direkam dalam rekam jepret yang sama, gunakan fungsi Process32Next.

Contoh

Misalnya, lihat Mengambil Rekam Jepret dan Menampilkan Proses.

Catatan

Header tlhelp32.h mendefinisikan Process32First sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor 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 XP [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target Windows
Header tlhelp32.h
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

CreateToolhelp32Snapshot

PROCESSENTRY32W

Proses Berjalan

Proses32NextW

Fungsi Bantuan Alat