Método ITaskSettings::p ut_IdleSettings (taskschd.h)

  • Artigo

Obtém ou define as informações que especificam como o Agendador de Tarefas executa tarefas quando o computador está em uma condição ociosa. Para obter informações sobre condições ociosas, consulte Condições ociosas da tarefa.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_IdleSettings(
  IIdleSettings *pIdleSettings
);

Parâmetros

pIdleSettings

Valor retornado

Nenhum

Comentários

Ao ler ou gravar XML para uma tarefa, essa configuração é especificada no elemento IdleSettings do esquema do Agendador de Tarefas.

Quando a economia de bateria estiver ativada, as tarefas do Agendador de Tarefas do Windows serão disparadas somente se a tarefa for:

  • Não for definida como Iniciar a tarefa somente se o computador estiver ocioso... (a tarefa não usa IdleSettings)
  • Não for definida para ser executada durante a manutenção automática (a tarefa não usa MaintenanceSettings)
  • For definida como Executar somente quando o usuário estiver conectado ( LogonType da tarefa é TASK_LOGON_INTERACTIVE_TOKEN ou TASK_LOGON_GROUP)
Todos os outros gatilhos são atrasados até que a economia de bateria esteja desativada. Para obter mais informações sobre como acessar o status de economia de bateria em seu aplicativo, consulte SYSTEM_POWER_STATUS. Para obter informações gerais sobre a economia de bateria, consulte economia de bateria (nas diretrizes do componente de hardware).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho taskschd.h
Biblioteca Taskschd.lib
DLL Taskschd.dll

Confira também

ITaskSettings

Agendador de Tarefas