Compartilhar via


Método IPrincipal::p ut_LogonType (taskschd.h)

Obtém ou define o método de logon de segurança necessário para executar as tarefas associadas à entidade de segurança.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_LogonType(
  TASK_LOGON_TYPE logon
);

Parâmetros

logon

Valor retornado

Nenhum

Comentários

Essa propriedade só é válida quando um identificador de usuário é especificado pela propriedade UserId .

Ao ler ou gravar XML para uma tarefa, o tipo de logon é especificado no <elemento LogonType> do esquema do Agendador de Tarefas.

Para uma tarefa, que contém uma ação de caixa de mensagem, a caixa de mensagem será exibida se a tarefa for ativada e a tarefa tiver um tipo de logon interativo. Para definir o tipo de logon da tarefa como interativo, especifique TASK_LOGON_INTERACTIVE_TOKEN ou TASK_LOGON_GROUP na propriedade LogonType da entidade de segurança da tarefa ou no parâmetro logonType de ITaskFolder::RegisterTask ou ITaskFolder::RegisterTaskDefinition.

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 estã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 de 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

IPrincipal

Agendador de Tarefas