estrutura AT_ENUM (lmat.h)

  • Artigo

A estrutura AT_ENUM contém informações sobre um trabalho enviado. A função NetScheduleJobEnum usa essa estrutura para enumerar e retornar informações sobre uma fila inteira de trabalhos enviados.

Sintaxe

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

Membros

JobId

Tipo: DWORD

O identificador de trabalho de um trabalho enviado (enfileirado).

JobTime

Tipo: DWORD_PTR

Um ponteiro para a hora do dia em que o trabalho está agendado para ser executado. A hora é a hora local em um computador no qual o serviço de agendamento está em execução; ele é medido a partir da meia-noite e é expresso em milissegundos.

DaysOfMonth

Tipo: DWORD

Um conjunto de sinalizadores de bits que representam os dias do mês. Para cada bit definido, o trabalho agendado será executado no momento especificado pelo membro JobTime , no dia correspondente do mês. O bit 0 corresponde ao primeiro dia do mês e assim por diante.

O valor da máscara de bits será zero se o trabalho tiver sido agendado para ser executado apenas uma vez, na primeira ocorrência especificada no membro JobTime

DaysOfWeek

Tipo: UCHAR

Um conjunto de sinalizadores de bits que representam os dias da semana. Para cada bit definido, o trabalho agendado será executado no momento especificado pelo membro JobTime , no dia correspondente da semana. O bit 0 corresponde à segunda-feira e assim por diante.

O valor da máscara de bits será zero se o trabalho tiver sido agendado para ser executado apenas uma vez, na primeira ocorrência especificada no membro JobTime .

Flags

Tipo: UCHAR

Um conjunto de sinalizadores de bits que descrevem as propriedades do trabalho. Esse membro pode ser um ou mais dos valores a seguir.

Valor Significado
JOB_RUN_PERIODICALLY
 Esse sinalizador é igual ao valor original, ou seja, o valor quando o trabalho foi enviado.
JOB_EXEC_ERROR
 Se esse sinalizador estiver definido, ele indicará que o serviço de agendamento falhou ao executar o trabalho com êxito na última vez em que foi agendado para ser executado.
JOB_RUNS_TODAY
 Se esse sinalizador estiver definido, ele indicará que o trabalho está agendado para ser executado no dia atual; o valor do membro JobTime é maior que a hora atual do dia no computador em que o trabalho está enfileirado.
JOB_NONINTERACTIVE
 Esse sinalizador é igual ao valor original, ou seja, o valor quando o trabalho foi enviado.

Command

Tipo: LPWSTR

Um ponteiro para uma cadeia de caracteres Unicode que contém o nome do comando, programa em lote ou arquivo binário a ser executado.

Comentários

Para obter mais informações sobre como definir os sinalizadores de bit para agendar trabalhos executados uma vez, trabalhos que são executados várias vezes e trabalhos executados periodicamente sem exclusão, consulte a função NetScheduleJobAdd .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho lmat.h (inclua Lm.h)

Confira também

NetScheduleJobEnum

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Agendar funções