estructura AT_ENUM (lmat.h)

  • Artículo

La estructura AT_ENUM contiene información sobre un trabajo enviado. La función NetScheduleJobEnum usa esta estructura para enumerar y devolver información sobre una cola completa de trabajos enviados.

Sintaxis

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

Members

JobId

Tipo: DWORD

Identificador de trabajo de un trabajo enviado (en cola).

JobTime

Tipo: DWORD_PTR

Puntero a la hora del día en la que se programa el trabajo para ejecutarse. La hora es la hora local en un equipo en el que se ejecuta el servicio de programación; se mide a partir de medianoche y se expresa en milisegundos.

DaysOfMonth

Tipo: DWORD

Conjunto de marcas de bits que representan los días del mes. Para cada bit que se establece, el trabajo programado se ejecutará en el momento especificado por el miembro JobTime , en el día correspondiente del mes. Bit 0 corresponde al primer día del mes, etc.

El valor de la máscara de bits es cero si el trabajo estaba programado para ejecutarse una sola vez, en la primera aparición especificada en el miembro JobTime .

DaysOfWeek

Tipo: UCHAR

Conjunto de marcas de bits que representan los días de la semana. Para cada bit que se establece, el trabajo programado se ejecutará en el momento especificado por el miembro JobTime , en el día correspondiente de la semana. Bit 0 corresponde al lunes, etc.

El valor de la máscara de bits es cero si el trabajo estaba programado para ejecutarse una sola vez, en la primera aparición especificada en el miembro JobTime .

Flags

Tipo: UCHAR

Conjunto de marcas de bits que describen las propiedades del trabajo. Este miembro puede ser uno o varios de los valores siguientes.

Valor Significado
JOB_RUN_PERIODICALLY
 Esta marca es igual a su valor original, es decir, el valor cuando se envió el trabajo.
JOB_EXEC_ERROR
 Si se establece esta marca, indica que el servicio de programación no pudo ejecutar correctamente el trabajo la última vez que se programó para ejecutarse.
JOB_RUNS_TODAY
 Si se establece esta marca, indica que el trabajo está programado para ejecutarse en el día actual; el valor del miembro JobTime es mayor que la hora actual del día en el equipo donde se pone en cola el trabajo.
JOB_NONINTERACTIVE
 Esta marca es igual a su valor original, es decir, el valor cuando se envió el trabajo.

Command

Tipo: LPWSTR

Puntero a una cadena Unicode que contiene el nombre del comando, el programa por lotes o el archivo binario que se va a ejecutar.

Comentarios

Para obtener más información sobre cómo establecer las marcas de bits para programar trabajos que se ejecutan una vez, trabajos que se ejecutan varias veces y trabajos que se ejecutan periódicamente sin eliminación, consulte la función NetScheduleJobAdd .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado lmat.h (include Lm.h)

Consulte también

NetScheduleJobEnum

Introducción a la administración de redes

Estructuras de administración de redes

Programar funciones