estructura AT_INFO (lmat.h)

  • Artículo

La estructura AT_INFO contiene información sobre un trabajo. La función NetScheduleJobAdd usa la estructura para especificar información al programar un trabajo. La función NetScheduleJobGetInfo usa la estructura para recuperar información sobre un trabajo que ya se ha enviado.

Sintaxis

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

Miembros

JobTime

Tipo: DWORD_PTR

Puntero a un valor que indica 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

Un conjunto de marcas de bits que representan los días del mes. Para cada bit establecido, 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 por el miembro JobTime .

DaysOfWeek

Tipo: UCHAR

Un 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 por el miembro JobTime .

Flags

Tipo: UCHAR

Conjunto de marcas de bits que describen las propiedades del trabajo.

Al enviar un trabajo mediante una llamada a la función NetScheduleJobAdd , puede especificar uno de los valores siguientes.

Valor Significado
JOB_RUN_PERIODICALLY
 Si establece esta marca, el trabajo se ejecuta y continúa ejecutándose, en cada día para el que se establece un bit correspondiente en el miembro DaysOfMonth o en el miembro DaysOfWeek . El trabajo no se elimina después de ejecutarlo.

Si esta marca está desactivada, el trabajo solo se ejecuta una vez para cada bit establecido en estos miembros. El trabajo se elimina después de que se ejecute una vez.
JOB_ADD_CURRENT_DATE
 Si establece esta marca, el trabajo se ejecuta en la primera aparición del miembro JobTime en el equipo donde se pone en cola el trabajo.

Establecer esta marca equivale a establecer el bit para el día actual en el miembro DaysOfMonth .
JOB_NONINTERACTIVE
 Si establece esta marca, el trabajo no se ejecuta de forma interactiva.

Si esta marca está desactivada, el trabajo se ejecuta de forma interactiva.
 

Al llamar a NetScheduleJobGetInfo para recuperar información del trabajo, la función puede devolver 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 estaba programada 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
 Este bit de 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 la programación de trabajos que se ejecutan una vez, trabajos que se ejecutan varias veces y trabajos que se ejecutan periódicamente sin eliminación, consulte NetScheduleJobAdd.

Requisitos

Requisito Value
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

NetScheduleJobAdd

NetScheduleJobGetInfo

Introducción a la administración de redes

Estructuras de administración de redes

Programar funciones