Interface IPrincipal (taskschd.h)
Fornece as credenciais de segurança para uma entidade de segurança. Essas credenciais de segurança definem o contexto de segurança para as tarefas associadas à entidade de segurança.
Herança
A interface IPrincipal herda da interface IDispatch.
Métodos
A interface IPrincipal tem esses métodos.
| IPrincipal::get_DisplayName Obtém ou define o nome da entidade de segurança. (Obter) |
| IPrincipal::get_GroupId Obtém ou define o identificador do grupo de usuários necessário para executar as tarefas associadas à entidade de segurança. (Obter) |
| IPrincipal::get_Id Obtém ou define o identificador da entidade de segurança. (Obter) |
| IPrincipal::get_LogonType Obtém ou define o método de logon de segurança necessário para executar as tarefas associadas à entidade de segurança. (Obter) |
| IPrincipal::get_RunLevel Obtém ou define o identificador usado para especificar o nível de privilégio necessário para executar as tarefas associadas à entidade de segurança. (Obter) |
| IPrincipal::get_UserId Obtém ou define o identificador de usuário necessário para executar as tarefas associadas à entidade de segurança. (Obter) |
| IPrincipal::p ut_DisplayName Obtém ou define o nome da entidade de segurança. (Put) |
| IPrincipal::p ut_GroupId Obtém ou define o identificador do grupo de usuários necessário para executar as tarefas associadas à entidade de segurança. (Put) |
| IPrincipal::p ut_Id Obtém ou define o identificador da entidade de segurança. (Put) |
| IPrincipal::p ut_LogonType Obtém ou define o método de logon de segurança necessário para executar as tarefas associadas à entidade de segurança. (Put) |
| IPrincipal::p ut_RunLevel Obtém ou define o identificador usado para especificar o nível de privilégio necessário para executar as tarefas associadas à entidade de segurança. (Put) |
| IPrincipal::p ut_UserId Obtém ou define o identificador de usuário necessário para executar as tarefas associadas à entidade de segurança. (Put) |
Comentários
Ao especificar uma conta, lembre-se de usar corretamente a barra invertida dupla no código para especificar o domínio e o nome de usuário. Por exemplo, use DOMAIN\UserName para especificar um valor para a propriedade UserId .
Ao ler ou gravar XML para uma tarefa, as credenciais de segurança de uma entidade de segurança são especificadas no elemento Principal do esquema do Agendador de Tarefas.
Se uma tarefa for registrada usando a ferramenta de linha de comando at.exe e essa interface for usada para recuperar informações sobre a tarefa, a propriedade LogonType retornará 0, a propriedade RunLevel retornará 0 e a propriedade UserId retornará NULL.
Exemplos
Para obter mais informações e código de exemplo para essa interface, consulte Exemplo de gatilho de tempo (C++) ou Exemplo de gatilho de registro (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 |