estrutura AT_INFO (lmat.h)

  • Artigo

A estrutura AT_INFO contém informações sobre um trabalho. A função NetScheduleJobAdd usa a estrutura para especificar informações ao agendar um trabalho. A função NetScheduleJobGetInfo usa a estrutura para recuperar informações sobre um trabalho que já foi enviado.

Sintaxe

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

Membros

JobTime

Tipo: DWORD_PTR

Um ponteiro para um valor que indica 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; é 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 pelo 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 a 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 pelo membro JobTime .

Flags

Tipo: UCHAR

Um conjunto de sinalizadores de bits que descrevem as propriedades do trabalho.

Ao enviar um trabalho usando uma chamada para a função NetScheduleJobAdd , você pode especificar um dos valores a seguir.

Valor Significado
JOB_RUN_PERIODICALLY
 Se você definir esse sinalizador, o trabalho será executado e continuará a ser executado em cada dia para o qual um bit correspondente será definido no membro DaysOfMonth ou no membro DaysOfWeek . O trabalho não é excluído após a execução.

Se esse sinalizador estiver claro, o trabalho será executado apenas uma vez para cada bit definido nesses membros. O trabalho é excluído depois de ser executado uma vez.
JOB_ADD_CURRENT_DATE
 Se você definir esse sinalizador, o trabalho será executado na primeira ocorrência de membro JobTime no computador em que o trabalho está enfileirado.

Definir esse sinalizador é equivalente a definir o bit para o dia atual no membro DaysOfMonth .
JOB_NONINTERACTIVE
 Se você definir esse sinalizador, o trabalho não será executado interativamente.

Se esse sinalizador estiver claro, o trabalho será executado interativamente.
 

Quando você chama NetScheduleJobGetInfo para recuperar informações de trabalho, a função pode retornar 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 bit de 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, do programa em lote ou do arquivo binário a ser executado.

Comentários

Para obter mais informações sobre como agendar trabalhos que são executados uma vez, trabalhos executados várias vezes e trabalhos executados periodicamente sem exclusão, consulte NetScheduleJobAdd.

Requisitos

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

NetScheduleJobAdd

NetScheduleJobGetInfo

Visão geral do gerenciamento de rede

Estruturas de gerenciamento de rede

Agendar funções