Interfaz IPrincipal (taskschd.h)
Proporciona las credenciales de seguridad de una entidad de seguridad. Estas credenciales de seguridad definen el contexto de seguridad de las tareas asociadas a la entidad de seguridad.
Herencia
La interfaz IPrincipal hereda de la interfaz IDispatch.
Métodos
La interfaz IPrincipal tiene estos métodos.
| IPrincipal::get_DisplayName Obtiene o establece el nombre de la entidad de seguridad. (Obtener) |
| IPrincipal::get_GroupId Obtiene o establece el identificador del grupo de usuarios necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Obtener) |
| IPrincipal::get_Id Obtiene o establece el identificador de la entidad de seguridad. (Obtener) |
| IPrincipal::get_LogonType Obtiene o establece el método de inicio de sesión de seguridad necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Obtener) |
| IPrincipal::get_RunLevel Obtiene o establece el identificador que se usa para especificar el nivel de privilegio necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Obtener) |
| IPrincipal::get_UserId Obtiene o establece el identificador de usuario necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Obtener) |
| IPrincipal::p ut_DisplayName Obtiene o establece el nombre de la entidad de seguridad. (Put) |
| IPrincipal::p ut_GroupId Obtiene o establece el identificador del grupo de usuarios necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Put) |
| IPrincipal::p ut_Id Obtiene o establece el identificador de la entidad de seguridad. (Put) |
| IPrincipal::p ut_LogonType Obtiene o establece el método de inicio de sesión de seguridad necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Put) |
| IPrincipal::p ut_RunLevel Obtiene o establece el identificador que se usa para especificar el nivel de privilegio necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Put) |
| IPrincipal::p ut_UserId Obtiene o establece el identificador de usuario necesario para ejecutar las tareas asociadas a la entidad de seguridad. (Put) |
Comentarios
Al especificar una cuenta, recuerde usar correctamente la barra diagonal inversa doble en el código para especificar el dominio y el nombre de usuario. Por ejemplo, use DOMAIN\UserName para especificar un valor para la propiedad UserId .
Al leer o escribir XML para una tarea, las credenciales de seguridad de una entidad de seguridad se especifican en el elemento Principal del esquema del Programador de tareas.
Si una tarea se registra mediante la herramienta de línea de comandos de at.exe, y esta interfaz se usa para recuperar información sobre la tarea, la propiedad LogonType devolverá 0, la propiedad RunLevel devolverá 0 y la propiedad UserId devolverá NULL.
Ejemplos
Para obtener más información y código de ejemplo para esta interfaz, vea Ejemplo de desencadenador de hora (C++) o Ejemplo de desencadenador de registro (C++).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | taskschd.h |