Fungsi GetCurrentProcess (processthreadsapi.h)

Artikel
02/07/2024

Mengambil handel pseudo untuk proses saat ini.

Sintaks

HANDLE GetCurrentProcess();

Mengembalikan nilai

Nilai yang dikembalikan adalah handel pseudo ke proses saat ini.

Keterangan

Handel semu adalah konstanta khusus, saat ini (HANDLE)-1, yang ditafsirkan sebagai handel proses saat ini. Untuk kompatibilitas dengan sistem operasi di masa depan, yang terbaik adalah memanggil GetCurrentProcess alih-alih mengodekan keras nilai konstan ini. Proses panggilan dapat menggunakan handel pseudo untuk menentukan prosesnya sendiri setiap kali handel proses diperlukan. Handel semu tidak diwariskan oleh proses anak.

Handel ini memiliki akses PROCESS_ALL_ACCESS ke objek proses. Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

Windows Server 2003 dan Windows XP: Handel ini memiliki akses maksimum yang diizinkan oleh pendeskripsi keamanan proses ke token utama proses.

Proses dapat membuat handel "nyata" ke dirinya sendiri yang valid dalam konteks proses lain, atau yang dapat diwariskan oleh proses lain, dengan menentukan handel pseudo sebagai handel sumber dalam panggilan ke fungsi DuplicateHandle . Proses juga dapat menggunakan fungsi OpenProcess untuk membuka handel nyata ke dirinya sendiri.

Handel pseudo tidak perlu ditutup ketika tidak lagi diperlukan. Memanggil fungsi CloseHandle dengan handel pseudo tidak berpengaruh. Jika handel pseudo diduplikasi oleh DuplicateHandle, handel duplikat harus ditutup.

Contoh

Misalnya, lihat Membuat Proses Anak dengan Input dan Output yang Dialihkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll