Fungsi NetScheduleJobEnum (lmat.h)
[NetScheduleJobEnum tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan Antarmuka Task Scheduler 2.0.
]
Fungsi NetScheduleJobEnum mencantumkan pekerjaan yang diantrekan pada komputer tertentu. Fungsi ini mengharuskan layanan jadwal dimulai.
Sintaks
NET_API_STATUS NET_API_FUNCTION NetScheduleJobEnum(
[in, optional] LPCWSTR Servername,
[out] LPBYTE *PointerToBuffer,
[in] DWORD PrefferedMaximumLength,
[out] LPDWORD EntriesRead,
[out] LPDWORD TotalEntries,
[in, out] LPDWORD ResumeHandle
);
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.
[out] PointerToBuffer
Penunjuk ke buffer yang menerima data. Informasi pengembalian adalah array struktur AT_ENUM . Buffer dialokasikan oleh sistem dan harus dikosongkan menggunakan satu panggilan ke fungsi NetApiBufferFree . Perhatikan bahwa Anda harus membebaskan buffer meskipun fungsi gagal dengan ERROR_MORE_DATA.
[in] PrefferedMaximumLength
Nilai yang menunjukkan panjang maksimum yang disukai dari data yang dikembalikan, dalam byte. Jika Anda menentukan MAX_PREFERRED_LENGTH, fungsi mengalokasikan jumlah memori yang diperlukan untuk data. Jika Anda menentukan nilai lain dalam parameter ini, nilai tersebut dapat membatasi jumlah byte yang dikembalikan fungsi. Jika ukuran buffer tidak cukup untuk menahan semua entri, fungsi akan mengembalikan ERROR_MORE_DATA. Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.
[out] EntriesRead
Penunjuk ke nilai yang menerima hitungan elemen yang benar-benar dijumlahkan.
[out] TotalEntries
Penunjuk ke nilai yang menerima jumlah total entri yang bisa dijumlahkan dari posisi resume saat ini. Perhatikan bahwa aplikasi harus mempertimbangkan nilai ini hanya sebagai petunjuk.
[in, out] ResumeHandle
Penunjuk ke nilai yang berisi handel resume yang digunakan untuk melanjutkan enumerasi pekerjaan. Handel harus nol pada panggilan pertama dan dibiarkan tidak berubah untuk panggilan berikutnya. Jika parameter ini NULL, maka tidak ada handel resume yang disimpan.
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 sedang dijumlahkan 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 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
Setiap entri yang dikembalikan berisi struktur AT_ENUM . Nilai anggota JobId dapat digunakan saat memanggil fungsi yang memerlukan parameter pengidentifikasi pekerjaan, seperti fungsi NetScheduleJobDel .
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 |