structure AT_ENUM (lmat.h)

  • Article

La structure AT_ENUM contient des informations sur un travail soumis. La fonction NetScheduleJobEnum utilise cette structure pour énumérer et retourner des informations sur l’ensemble d’une file d’attente de travaux envoyés.

Syntaxe

typedef struct _AT_ENUM {
  DWORD     JobId;
  DWORD_PTR JobTime;
  DWORD     DaysOfMonth;
  UCHAR     DaysOfWeek;
  UCHAR     Flags;
  LPWSTR    Command;
} AT_ENUM, *PAT_ENUM, *LPAT_ENUM;

Membres

JobId

Type : DWORD

Identificateur de travail d’un travail soumis (mis en file d’attente).

JobTime

Type : DWORD_PTR

Pointeur vers l’heure de la journée à laquelle l’exécution du travail est planifiée. L’heure est l’heure locale sur un ordinateur sur lequel le service de planification est en cours d’exécution ; elle est mesurée à partir de minuit et est exprimée en millisecondes.

DaysOfMonth

Type : DWORD

Ensemble d’indicateurs de bits représentant les jours du mois. Pour chaque bit défini, le travail planifié s’exécute à l’heure spécifiée par le membre JobTime , le jour correspondant du mois. Le bit 0 correspond au premier jour du mois, et ainsi de suite.

La valeur du masque de bits est zéro si le travail a été planifié pour s’exécuter une seule fois, à la première occurrence spécifiée dans le membre JobTime

DaysOfWeek

Type : UCHAR

Ensemble d’indicateurs de bits représentant les jours de la semaine. Pour chaque bit défini, le travail planifié s’exécute à l’heure spécifiée par le membre JobTime , le jour correspondant de la semaine. Le bit 0 correspond au lundi, et ainsi de suite.

La valeur du masque de bits est zéro si le travail a été planifié pour s’exécuter une seule fois, à la première occurrence spécifiée dans le membre JobTime .

Flags

Type : UCHAR

Ensemble d’indicateurs de bits décrivant les propriétés du travail. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur Signification
JOB_RUN_PERIODICALLY
 Cet indicateur est égal à sa valeur d’origine, c’est-à-dire la valeur au moment de l’envoi du travail.
JOB_EXEC_ERROR
 Si cet indicateur est défini, cela indique que le service de planification n’a pas réussi à exécuter le travail la dernière fois qu’il a été planifié pour s’exécuter.
JOB_RUNS_TODAY
 Si cet indicateur est défini, cela indique que le travail est planifié pour s’exécuter le jour actuel ; la valeur du membre JobTime est supérieure à l’heure actuelle de la journée sur l’ordinateur où le travail est mis en file d’attente.
JOB_NONINTERACTIVE
 Cet indicateur est égal à sa valeur d’origine, c’est-à-dire la valeur au moment de l’envoi du travail.

Command

Type : LPWSTR

Pointeur vers une chaîne Unicode qui contient le nom de la commande, du programme de traitement par lots ou du fichier binaire à exécuter.

Notes

Pour plus d’informations sur la définition des indicateurs de bits pour planifier des travaux qui s’exécutent une fois, des travaux qui s’exécutent plusieurs fois et des travaux qui s’exécutent régulièrement sans suppression, consultez la fonction NetScheduleJobAdd .

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête lmat.h (include Lm.h)

Voir aussi

NetScheduleJobEnum

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Fonctions de planification