structure AT_INFO (lmat.h)

Article
02/28/2024

La structure AT_INFO contient des informations sur un travail. La fonction NetScheduleJobAdd utilise la structure pour spécifier des informations lors de la planification d’un travail. La fonction NetScheduleJobGetInfo utilise la structure pour récupérer des informations sur un travail qui a déjà été envoyé.

Syntaxe

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

Membres

JobTime

Type : DWORD_PTR

Pointeur vers une valeur qui indique 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 par 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 par le membre JobTime .

Flags

Type : UCHAR

Ensemble d’indicateurs de bits décrivant les propriétés du travail.

Lorsque vous envoyez un travail à l’aide d’un appel à la fonction NetScheduleJobAdd , vous pouvez spécifier l’une des valeurs suivantes.

Valeur	Signification
JOB_RUN_PERIODICALLY	Si vous définissez cet indicateur, le travail s’exécute et continue de s’exécuter chaque jour pour lequel un bit correspondant est défini dans le membre DaysOfMonth ou le membre DaysOfWeek . Le travail n’est pas supprimé après son exécution. Si cet indicateur est clair, le travail ne s’exécute qu’une seule fois pour chaque bit défini dans ces membres. Le travail est supprimé après s’être exécuté une fois.
JOB_ADD_CURRENT_DATE	Si vous définissez cet indicateur, le travail s’exécute à la première occurrence du membre JobTime sur l’ordinateur où le travail est mis en file d’attente. La définition de cet indicateur équivaut à définir le bit pour le jour actuel dans le membre DaysOfMonth .
JOB_NONINTERACTIVE	Si vous définissez cet indicateur, le travail ne s’exécute pas de manière interactive. Si cet indicateur est clair, le travail s’exécute de manière interactive.

Lorsque vous appelez NetScheduleJobGetInfo pour récupérer des informations sur le travail, la fonction peut retourner 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	Ce bit d’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.

Remarques

Pour plus d’informations sur la planification 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 NetScheduleJobAdd.

Configuration requise

Condition requise	Valeur
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

NetScheduleJobAdd

NetScheduleJobGetInfo

Vue d’ensemble de la gestion du réseau

Structures de gestion réseau

Fonctions de planification

Partager via