struktur AT_INFO (lmat.h)

Artikel
08/24/2023

Struktur AT_INFO berisi informasi tentang pekerjaan. Fungsi NetScheduleJobAdd menggunakan struktur untuk menentukan informasi saat menjadwalkan pekerjaan. Fungsi NetScheduleJobGetInfo menggunakan struktur untuk mengambil informasi tentang pekerjaan yang telah dikirimkan.

Sintaks

typedef struct _AT_INFO {
  DWORD_PTR JobTime;
  DWORD     DaysOfMonth;
  UCHAR     DaysOfWeek;
  UCHAR     Flags;
  LPWSTR    Command;
} AT_INFO, *PAT_INFO, *LPAT_INFO;

Anggota

JobTime

Jenis: DWORD_PTR

Penunjuk ke nilai yang menunjukkan waktu hari di mana pekerjaan dijadwalkan untuk dijalankan. Waktunya adalah waktu lokal di komputer tempat layanan jadwal berjalan; diukur dari tengah malam, dan dinyatakan dalam milidetik.

DaysOfMonth

Jenis: DWORD

Sekumpulan bendera bit yang mewakili hari dalam sebulan. Untuk setiap bit yang ditetapkan, pekerjaan terjadwal akan berjalan pada waktu yang ditentukan oleh anggota JobTime , pada hari yang sesuai dalam sebulan. Bit 0 sesuai dengan hari pertama dalam sebulan, dan sebagainya.

Nilai bitmask adalah nol jika pekerjaan dijadwalkan untuk berjalan hanya sekali, pada kemunculan pertama yang ditentukan oleh anggota JobTime .

DaysOfWeek

Jenis: UCHAR

Sekumpulan bendera bit yang mewakili hari dalam seminggu. Untuk setiap bit yang ditetapkan, pekerjaan terjadwal akan berjalan pada waktu yang ditentukan oleh anggota JobTime , pada hari yang sesuai dalam seminggu. Bit 0 sesuai dengan Senin, dan sebagainya.

Nilai bitmask adalah nol jika pekerjaan dijadwalkan untuk berjalan hanya sekali, pada kemunculan pertama yang ditentukan oleh anggota JobTime .

Flags

Jenis: UCHAR

Sekumpulan bendera bit yang menjelaskan properti pekerjaan.

Saat Anda mengirimkan pekerjaan menggunakan panggilan ke fungsi NetScheduleJobAdd , Anda bisa menentukan salah satu nilai berikut.

Nilai	Makna
JOB_RUN_PERIODICALLY	Jika Anda mengatur bendera ini, pekerjaan berjalan, dan terus berjalan, pada setiap hari di mana bit yang sesuai diatur dalam anggota DaysOfMonth atau anggota DaysOfWeek . Pekerjaan tidak dihapus setelah dijalankan. Jika bendera ini jelas, pekerjaan hanya berjalan sekali untuk setiap bit yang diatur dalam anggota ini. Pekerjaan dihapus setelah dijalankan sekali.
JOB_ADD_CURRENT_DATE	Jika Anda mengatur bendera ini, pekerjaan dijalankan pada kemunculan pertama anggota JobTime di komputer tempat pekerjaan diantrekan. Mengatur bendera ini setara dengan mengatur bit untuk hari ini di anggota DaysOfMonth .
JOB_NONINTERACTIVE	Jika Anda mengatur bendera ini, pekerjaan tidak berjalan secara interaktif. Jika bendera ini jelas, pekerjaan berjalan secara interaktif.

Saat Anda memanggil NetScheduleJobGetInfo untuk mengambil informasi pekerjaan, fungsi dapat mengembalikan satu atau beberapa nilai berikut.

Nilai	Makna
JOB_RUN_PERIODICALLY	Bendera ini sama dengan nilai aslinya, yaitu nilai ketika pekerjaan dikirimkan.
JOB_EXEC_ERROR	Jika bendera ini diatur, ini menunjukkan bahwa layanan jadwal gagal menjalankan pekerjaan terakhir kali dijadwalkan untuk dijalankan.
JOB_RUNS_TODAY	Jika bendera ini diatur, itu menunjukkan bahwa pekerjaan dijadwalkan untuk dijalankan pada hari ini; nilai anggota JobTime lebih besar dari waktu saat ini di komputer tempat pekerjaan diantrekan.
JOB_NONINTERACTIVE	Bit bendera ini sama dengan nilai aslinya, yaitu nilai ketika pekerjaan dikirimkan.

Command

Jenis: LPWSTR

Penunjuk ke string Unicode yang berisi nama perintah, program batch, atau file biner untuk dijalankan.

Keterangan

Untuk informasi selengkapnya tentang penjadwalan pekerjaan yang dijalankan sekali, pekerjaan yang dijalankan beberapa kali, dan pekerjaan yang dijalankan secara berkala tanpa penghapusan, lihat NetScheduleJobAdd.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	lmat.h (termasuk Lm.h)

Lihat juga

NetScheduleJobAdd

NetScheduleJobGetInfo

Gambaran Umum Manajemen Jaringan

Struktur Manajemen Jaringan

Fungsi Jadwal

Bagikan melalui