Fungsi NetScheduleJobAdd (lmat.h)

Artikel
08/24/2023

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

]

Fungsi NetScheduleJobAdd mengirimkan pekerjaan untuk dijalankan pada waktu dan tanggal mendatang yang ditentukan. Fungsi ini mengharuskan layanan jadwal dimulai pada komputer tempat pekerjaan dikirimkan.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetScheduleJobAdd(
  [in, optional] LPCWSTR Servername,
  [in]           LPBYTE  Buffer,
  [out]          LPDWORD JobId
);

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] Buffer

Penunjuk ke struktur AT_INFO yang menjelaskan pekerjaan yang akan dikirimkan. Untuk informasi selengkapnya tentang penjadwalan pekerjaan menggunakan properti pekerjaan yang berbeda, lihat bagian Keterangan berikut dan Buffer Fungsi Manajemen Jaringan.

[out] JobId

Pointer yang menerima pengidentifikasi pekerjaan untuk pekerjaan yang baru dikirimkan. Entri ini hanya valid jika fungsi berhasil dikembalikan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan 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 ditambahkan dapat 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 jarak jauh 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

Berikut ini adalah contoh cara menjadwalkan pekerjaan menggunakan properti berbeda yang didukung oleh fungsi NetScheduleJobAdd .

Untuk menjadwalkan pekerjaan yang dijalankan sekali:

Atur anggota DaysOfMonth dari struktur AT_INFO ke nol.
Atur anggota DaysOfWeek dari struktur AT_INFO ke nol.
Atur anggota JobTime dari struktur AT_INFO ke waktu pekerjaan harus dijalankan.

Pekerjaan dijalankan pada saat yang ditentukan oleh anggota JobTime dari struktur AT_INFO yang ditujukkan oleh parameter Buffer . Setelah pekerjaan dijalankan, pekerjaan akan dihapus.

Untuk menjadwalkan dan menghapus pekerjaan yang dijalankan beberapa kali:

Atur bit yang sesuai di anggota DaysOfMonth dari struktur AT_INFO atau
Atur bit yang sesuai di anggota DaysOfWeek dari struktur AT_INFO .
Atur anggota JobTime dari struktur AT_INFO ke waktu pekerjaan harus dijalankan.

Catatan Anda tidak perlu mengatur anggota DaysOfMonth dan DaysOfWeek dari struktur AT_INFO .

Pekerjaan dijalankan pada waktu yang ditentukan oleh anggota JobTime dari struktur AT_INFO yang ditunjukkan oleh parameter Buffer , sekali untuk setiap hari yang ditetapkan dalam anggota DaysOfMonth atau DaysOfWeek dari struktur AT_INFO . Setelah setiap pekerjaan dijalankan, bit yang sesuai dibersihkan. Ketika bit terakhir dibersihkan, pekerjaan akan dihapus.

Untuk menjadwalkan pekerjaan yang dijalankan secara berkala:

Atur bit yang sesuai di anggota DaysOfMonth dari struktur AT_INFO atau
Atur bit yang sesuai di anggota DaysOfWeek dari struktur AT_INFO .
Atur anggota JobTime dari struktur AT_INFO ke waktu pekerjaan harus dijalankan.
Atur bendera pengiriman pekerjaan JOB_RUN_PERIODICALLY di anggota Bendera struktur AT_INFO .

Catatan Anda tidak perlu mengatur anggota DaysOfMonth dan DaysOfWeek dari struktur AT_INFO .

Pekerjaan akan dijalankan secara berkala, pada waktu yang ditentukan oleh anggota JobTime dari struktur AT_INFO yang ditunjukkan oleh parameter Buffer , pada setiap hari yang ditetapkan dalam anggota DaysOfMonth atau DaysOfWeek dari struktur AT_INFO . Pekerjaan tidak akan dihapus sebagai akibat dari eksekusi berulang. Satu-satunya cara untuk menghapus pekerjaan adalah dengan panggilan eksplisit ke fungsi NetScheduleJobDel .

Lihat struktur AT_INFO untuk deskripsi bitmask properti DaysOfWeek, DaysOfMonth, dan job.

Pada Windows 2000, layanan AT sebelumnya dan Penjadwal Tugas digabungkan. Layanan Penjadwal Tugas hanya akurat hingga menit. Oleh karena itu, fungsi NetScheduleJobAdd hanya menggunakan jam dan menit yang ditentukan dalam anggota JobTime dari struktur AT_INFO ketika pekerjaan dijadwalkan untuk dijalankan.

Dimulai dengan Windows Vista, presisi untuk Penjadwal Tugas ditingkatkan menjadi yang kedua. Oleh karena itu, fungsi NetScheduleJobAdd hanya menggunakan jam, menit, dan detik yang ditentukan dalam anggota JobTime dari struktur AT_INFO ketika pekerjaan dijadwalkan untuk dijalankan.

Persyaratan

Persyaratan	Nilai
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