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

  • Artigo

Obtém ou define um valor booliano que indica que o Agendador de Tarefas ativará o computador quando for a hora de executar a tarefa e manterá o computador ativo até que a tarefa seja concluída.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_WakeToRun(
  VARIANT_BOOL wake
);

Parâmetros

wake

Valor retornado

Nenhum

Comentários

Se uma tarefa tiver essa propriedade definida como true e for disparada quando o computador já estiver ativo, o Agendador de Tarefas solicitará que o computador permaneça ativo até que a tarefa seja concluída em execução.

Quando o serviço Agendador de Tarefas ativa o computador para executar uma tarefa, a tela pode permanecer desligada mesmo que o computador não esteja mais no modo de suspensão ou hibernação. A tela será ativada quando o Windows Vista detectar que um usuário retornou para usar o computador.

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

Requisitos

   
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