Fungsi NetScheduleJobDel (lmat.h)

Artikel
03/14/2023

[NetScheduleJobDel tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan Antarmuka Task Scheduler 2.0.

]

Fungsi NetScheduleJobDel menghapus berbagai pekerjaan yang diantrekan untuk dijalankan di komputer. Fungsi ini mengharuskan layanan jadwal dimulai di komputer tempat permintaan penghapusan pekerjaan dikirim.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   MinJobId,
  [in]           DWORD   MaxJobId
);

Parameter

[in, optional] Servername

Penunjuk ke string konstanta yang menentukan nama DNS atau NetBIOS dari server jarak jauh tempat fungsi dijalankan. Jika parameter ini NULL, komputer lokal akan digunakan.

[in] MinJobId

Pengidentifikasi pekerjaan minimum. Pekerjaan dengan pengidentifikasi pekerjaan yang lebih kecil dari MinJobId tidak akan dihapus.

[in] MaxJobId

Pengidentifikasi pekerjaan maksimum. Pekerjaan dengan pengidentifikasi pekerjaan yang lebih besar dari MaxJobId tidak akan dihapus.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NERR_Success.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem. Untuk daftar kode kesalahan, lihat Kode Kesalahan Sistem.

Keterangan

Biasanya hanya anggota grup Administrator lokal di komputer tempat pekerjaan jadwal dihapus berhasil menjalankan fungsi ini. Jika nama server yang diteruskan dalam string yang diarahkan oleh parameter Servername adalah server jarak jauh, maka hanya anggota grup Administrator lokal di server yang berhasil menjalankan fungsi ini.

Jika nilai registri berikut memiliki set bit yang paling tidak signifikan (misalnya, 0x00000001), maka pengguna yang termasuk dalam grup Operator Server juga dapat berhasil menjalankan fungsi ini.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Panggil fungsi NetScheduleJobEnum untuk mengambil pengidentifikasi pekerjaan untuk satu atau beberapa pekerjaan terjadwal.

Fungsi NetScheduleJobDel menghapus semua pekerjaan yang pengidentifikasi pekerjaannya berada dalam rentang MinJobId melalui MaxJobId.

Untuk menghapus semua pekerjaan terjadwal di server, Anda dapat memanggil NetScheduleJobDel yang menentukan MinJobId sama dengan 0 dan MaxJobId sama dengan – 1. Untuk menghapus satu pekerjaan, tentukan pengidentifikasi pekerjaan untuk parameter MinJobId dan parameter MaxJobId .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	lmat.h (termasuk Lmat.h)
Pustaka	Netapi32.lib
DLL	Netapi32.dll