Fungsi OpenJobObjectA (winbase.h)
Membuka objek pekerjaan yang ada.
Sintaks
HANDLE OpenJobObjectA(
[in] DWORD dwDesiredAccess,
[in] BOOL bInheritHandle,
[in] LPCSTR lpName
);
Parameter
[in] dwDesiredAccess
Akses ke objek pekerjaan. Parameter ini bisa menjadi satu atau beberapa hak akses objek pekerjaan. Hak akses ini diperiksa terhadap deskriptor keamanan untuk objek tersebut.
[in] bInheritHandle
Jika nilai ini TRUE, proses yang dibuat oleh proses ini akan mewarisi handel. Jika tidak, proses tidak mewarisi handel ini.
[in] lpName
Nama pekerjaan yang akan dibuka. Perbandingan nama peka huruf besar/kecil.
Fungsi ini dapat membuka objek di namespace privat. Untuk informasi selengkapnya, lihat Namespace Objek.
Layanan Terminal: Nama dapat memiliki awalan "Global" atau "Lokal" untuk secara eksplisit membuka objek di namespace layanan global atau sesi. Sisa nama dapat berisi karakter apa pun kecuali karakter garis miring terbelakang (\). Untuk informasi selengkapnya, lihat Namespace Objek Kernel.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel untuk pekerjaan. Handel menyediakan akses yang diminta ke pekerjaan.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Kesalahan ERROR_FILE_NOT_FOUND menunjukkan bahwa pekerjaan yang ditentukan dalam lpName tidak ada.
Keterangan
Untuk mengaitkan proses dengan pekerjaan, gunakan fungsi AssignProcessToJobObject .
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winbase.h (termasuk Windows.h, Jobapi2.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |