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

Lihat juga

AssignProcessToJobObject

Objek Pekerjaan

Fungsi Proses dan Utas