Interface ITaskSettings (taskschd.h)
Fornece as configurações que o serviço Agendador de Tarefas usa para executar a tarefa.
Herança
A interface ITaskSettings herda da interface IDispatch.
Métodos
A interface ITaskSettings tem esses métodos.
| ITaskSettings::get_AllowDemandStart Obtém ou define um valor booliano que indica que a tarefa pode ser iniciada usando o comando Executar ou o menu Contexto. (Obter) |
| ITaskSettings::get_AllowHardTerminate Obtém ou define um valor booliano que indica que a tarefa pode ser encerrada pelo serviço Agendador de Tarefas usando TerminateProcess. (Obter) |
| ITaskSettings::get_Compatibility Obtém ou define um valor inteiro que indica com qual versão do Agendador de Tarefas uma tarefa é compatível. (Obter) |
| ITaskSettings::get_DeleteExpiredTaskAfter Obtém ou define a quantidade de tempo que o Agendador de Tarefas aguardará antes de excluir a tarefa depois que ela expirar. (Obter) |
| ITaskSettings::get_DisallowStartIfOnBatteries Obtém ou define um valor booliano que indica que a tarefa não será iniciada se o computador estiver em execução em baterias. (Obter) |
| ITaskSettings::get_Enabled Obtém ou define um valor booliano que indica que a tarefa está habilitada. A tarefa só pode ser executada quando essa configuração é True. |
| ITaskSettings::get_ExecutionTimeLimit Obtém ou define a quantidade de tempo que tem permissão para concluir a tarefa. (Obter) |
| ITaskSettings::get_Hidden Obtém ou define um valor booliano que indica que a tarefa não ficará visível na interface do usuário. (Obter) |
| ITaskSettings::get_IdleSettings 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. (Obter) |
| ITaskSettings::get_MultipleInstances Obtém ou define a política que define como o Agendador de Tarefas lida com várias instâncias da tarefa. (Obter) |
| ITaskSettings::get_NetworkSettings Obtém ou define o objeto de configurações de rede que contém um nome e um identificador de perfil de rede. (Obter) |
| ITaskSettings::get_Priority Obtém ou define o nível de prioridade da tarefa. (Obter) |
| ITaskSettings::get_RestartCount Obtém ou define o número de vezes que o Agendador de Tarefas tentará reiniciar a tarefa. (Obter) |
| ITaskSettings::get_RestartInterval Obtém ou define um valor que especifica por quanto tempo o Agendador de Tarefas tentará reiniciar a tarefa. (Obter) |
| ITaskSettings::get_RunOnlyIfIdle Obtém ou define um valor booliano que indica que o Agendador de Tarefas executará a tarefa somente se o computador estiver em uma condição ociosa. (Obter) |
| ITaskSettings::get_RunOnlyIfNetworkAvailable Obtém ou define um valor booliano que indica que o Agendador de Tarefas executará a tarefa somente quando uma rede estiver disponível. (Obter) |
| ITaskSettings::get_StartWhenAvailable Obtém ou define um valor booliano que indica que o Agendador de Tarefas pode iniciar a tarefa a qualquer momento depois que o horário agendado tiver passado. (Obter) |
| ITaskSettings::get_StopIfGoingOnBatteries Obtém ou define um valor booliano que indica que a tarefa será interrompida se o computador estiver indo para baterias. (Obter) |
| ITaskSettings::get_WakeToRun 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. (Obter) |
| ITaskSettings::get_XmlText Obtém ou define uma definição formatada em XML das configurações de tarefa. (Obter) |
| ITaskSettings::p ut_AllowDemandStart Obtém ou define um valor booliano que indica que a tarefa pode ser iniciada usando o comando Executar ou o menu Contexto. (Put) |
| ITaskSettings::p ut_AllowHardTerminate Obtém ou define um valor booliano que indica que a tarefa pode ser encerrada pelo serviço Agendador de Tarefas usando TerminateProcess. (Put) |
| ITaskSettings::p ut_Compatibility Obtém ou define um valor inteiro que indica com qual versão do Agendador de Tarefas uma tarefa é compatível. (Put) |
| ITaskSettings::p ut_DeleteExpiredTaskAfter Obtém ou define a quantidade de tempo que o Agendador de Tarefas aguardará antes de excluir a tarefa depois que ela expirar. (Put) |
| ITaskSettings::p ut_DisallowStartIfOnBatteries Obtém ou define um valor booliano que indica que a tarefa não será iniciada se o computador estiver em execução em baterias. (Put) |
| ITaskSettings::p ut_ExecutionTimeLimit Obtém ou define a quantidade de tempo que tem permissão para concluir a tarefa. (Put) |
| ITaskSettings::p ut_Hidden Obtém ou define um valor booliano que indica que a tarefa não ficará visível na interface do usuário. (Put) |
| ITaskSettings::p ut_IdleSettings 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. (Put) |
| ITaskSettings::p ut_MultipleInstances Obtém ou define a política que define como o Agendador de Tarefas lida com várias instâncias da tarefa. (Put) |
| ITaskSettings::p ut_NetworkSettings Obtém ou define o objeto de configurações de rede que contém um nome e um identificador de perfil de rede. (Put) |
| ITaskSettings::p ut_Priority Obtém ou define o nível de prioridade da tarefa. (Put) |
| ITaskSettings::p ut_RestartCount Obtém ou define o número de vezes que o Agendador de Tarefas tentará reiniciar a tarefa. (Put) |
| ITaskSettings::p ut_RestartInterval Obtém ou define um valor que especifica por quanto tempo o Agendador de Tarefas tentará reiniciar a tarefa. (Put) |
| ITaskSettings::p ut_RunOnlyIfIdle Obtém ou define um valor booliano que indica que o Agendador de Tarefas executará a tarefa somente se o computador estiver em uma condição ociosa. (Put) |
| ITaskSettings::p ut_RunOnlyIfNetworkAvailable Obtém ou define um valor booliano que indica que o Agendador de Tarefas executará a tarefa somente quando uma rede estiver disponível. (Put) |
| ITaskSettings::p ut_StartWhenAvailable Obtém ou define um valor booliano que indica que o Agendador de Tarefas pode iniciar a tarefa a qualquer momento depois que o horário agendado tiver passado. (Put) |
| ITaskSettings::p ut_StopIfGoingOnBatteries Obtém ou define um valor booliano que indica que a tarefa será interrompida se o computador estiver indo para baterias. (Put) |
| ITaskSettings::p ut_WakeToRun Obtém ou define um valor booliano que indica que o Agendador de Tarefas ativará o computador quando for hora de executar a tarefa e manterá o computador acordado até que a tarefa seja concluída. (Put) |
| ITaskSettings::p ut_XmlText Obtém ou define uma definição formatada em XML das configurações da tarefa. (Put) |
Comentários
Por padrão, uma tarefa será interrompida 72 horas depois de começar a ser executada. Você pode alterar isso alterando a configuração ExecutionTimeLimit .
Ao ler ou gravar XML para uma tarefa, as configurações de tarefa são definidas no elemento Configurações do esquema 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)
Exemplos
Para obter mais informações e um exemplo de código para essa interface, consulte Exemplo de gatilho de tempo (C++).
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 |