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

Consulte también

ITaskDefinition

Propiedad Principal de ITaskDefinition

Interfaces del programador de tareas