Fungsi NetScheduleJobGetInfo (lmat.h)

Artikel
08/24/2023

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

]

Fungsi NetScheduleJobGetInfo mengambil informasi tentang pekerjaan tertentu yang diantrekan pada komputer tertentu. Fungsi ini mengharuskan layanan jadwal dimulai.

Sintaks

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

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

Nilai yang menunjukkan pengidentifikasi pekerjaan untuk mengambil informasi.

[out] PointerToBuffer

Penunjuk ke buffer yang menerima struktur AT_INFO yang menjelaskan pekerjaan yang ditentukan. Buffer ini dialokasikan oleh sistem dan harus dibebaskan menggunakan fungsi NetApiBufferFree . Untuk informasi selengkapnya, lihat Buffer Fungsi Manajemen Jaringan dan Panjang Buffer Fungsi Manajemen Jaringan.

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

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