struttura AT_INFO (lmat.h)

  • Articolo

La struttura AT_INFO contiene informazioni su un processo. La funzione NetScheduleJobAdd usa la struttura per specificare le informazioni durante la pianificazione di un processo. La funzione NetScheduleJobGetInfo usa la struttura per recuperare informazioni su un processo già inviato.

Sintassi

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

Members

JobTime

Tipo: DWORD_PTR

Puntatore a un valore che indica l'ora del giorno in cui è pianificato l'esecuzione del processo. L'ora è l'ora locale in un computer in cui è in esecuzione il servizio di pianificazione; viene misurato dalla mezzanotte e espresso in millisecondi.

DaysOfMonth

Tipo: DWORD

Set di flag di bit che rappresentano i giorni del mese. Per ogni bit impostato, il processo pianificato verrà eseguito al momento specificato dal membro JobTime , il giorno corrispondente del mese. Bit 0 corrisponde al primo giorno del mese e così via.

Il valore della maschera di bit è zero se il processo è stato pianificato per l'esecuzione una sola volta, alla prima occorrenza specificata dal membro JobTime .

DaysOfWeek

Tipo: UCHAR

Set di flag di bit che rappresentano i giorni della settimana. Per ogni bit impostato, il processo pianificato verrà eseguito al momento specificato dal membro JobTime , nel giorno corrispondente della settimana. Bit 0 corrisponde al lunedì e così via.

Il valore della maschera di bit è zero se il processo è stato pianificato per l'esecuzione una sola volta, alla prima occorrenza specificata dal membro JobTime .

Flags

Tipo: UCHAR

Set di flag di bit che descrivono le proprietà del processo.

Quando si invia un processo usando una chiamata alla funzione NetScheduleJobAdd , è possibile specificare uno dei valori seguenti.

Valore Significato
JOB_RUN_PERIODICALLY
 Se si imposta questo flag, il processo viene eseguito e continua l'esecuzione, ogni giorno per il quale viene impostato un bit corrispondente nel membro DaysOfMonth o nel membro DaysOfWeek . Il processo non viene eliminato dopo l'esecuzione.

Se questo flag è chiaro, il processo viene eseguito una sola volta per ogni bit impostato in questi membri. Il processo viene eliminato dopo l'esecuzione una sola volta.
JOB_ADD_CURRENT_DATE
 Se si imposta questo flag, il processo viene eseguito alla prima occorrenza del membro JobTime nel computer in cui viene accodato il processo.

L'impostazione di questo flag equivale all'impostazione del bit per il giorno corrente nel membro DaysOfMonth .
JOB_NONINTERACTIVE
 Se si imposta questo flag, il processo non viene eseguito in modo interattivo.

Se questo flag è chiaro, il processo viene eseguito in modo interattivo.
 

Quando si chiama NetScheduleJobGetInfo per recuperare le informazioni sul processo, la funzione può restituire uno o più dei valori seguenti.

Valore Significato
JOB_RUN_PERIODICALLY
 Questo flag è uguale al valore originale, ovvero il valore quando il processo è stato inviato.
JOB_EXEC_ERROR
 Se questo flag è impostato, indica che il servizio di pianificazione non è riuscito a eseguire correttamente il processo l'ultima volta che è stata pianificata l'esecuzione.
JOB_RUNS_TODAY
 Se questo flag è impostato, indica che il processo è pianificato per l'esecuzione nel giorno corrente; il valore del membro JobTime è maggiore dell'ora corrente del giorno nel computer in cui viene accodato il processo.
JOB_NONINTERACTIVE
 Questo bit di flag è uguale al valore originale, ovvero il valore quando il processo è stato inviato.

Command

Tipo: LPWSTR

Puntatore a una stringa Unicode contenente il nome del comando, del programma batch o del file binario da eseguire.

Commenti

Per altre informazioni sulla pianificazione di processi eseguiti una sola volta, processi eseguiti più volte e processi eseguiti periodicamente senza eliminazione, vedere NetScheduleJobAdd.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione lmat.h (include Lm.h)

Vedi anche

NetScheduleJobAdd

NetScheduleJobGetInfo

Panoramica della gestione della rete

Strutture di gestione di rete

Funzioni di pianificazione