Método IPrincipal::get_LogonType (taskschd.h)

Obtiene o establece el método de inicio de sesión de seguridad necesario para ejecutar las tareas asociadas a la entidad de seguridad.

Esta propiedad es de lectura y escritura.

Sintaxis

HRESULT get_LogonType(
  TASK_LOGON_TYPE *pLogon
);

Parámetros

pLogon

Valor devuelto

None

Observaciones

Esta propiedad solo es válida cuando la propiedad UserId especifica un identificador de usuario.

Al leer o escribir XML para una tarea, el tipo de inicio de sesión se especifica en el <elemento LogonType> del esquema del Programador de tareas.

Para una tarea, que contiene una acción de cuadro de mensaje, se mostrará el cuadro de mensaje si la tarea está activada y la tarea tiene un tipo de inicio de sesión interactivo. Para establecer el tipo de inicio de sesión de tarea en interactivo, especifique TASK_LOGON_INTERACTIVE_TOKEN o TASK_LOGON_GROUP en la propiedad LogonType de la entidad de seguridad de la tarea, o en el parámetro logonType de ITaskFolder::RegisterTask o ITaskFolder::RegisterTaskDefinition.

Cuando el ahorro de batería está activado, las tareas del Programador de tareas de Windows solo se desencadenan si la tarea es:

  • No está establecida en Iniciar la tarea solo si el equipo está inactivo... (la tarea no usa IdleSettings)
  • No está establecida para ejecutarse durante el mantenimiento automático (la tarea no usa MaintenanceSettings)
  • Está establecida en Ejecutar solo cuando el usuario ha iniciado sesión (la tarea LogonType es TASK_LOGON_INTERACTIVE_TOKEN o TASK_LOGON_GROUP)
Todos los demás desencadenadores se retrasan hasta que el ahorro de batería está apagado. Para obtener más información sobre el acceso al estado de ahorro de batería en la aplicación, consulte SYSTEM_POWER_STATUS. Para obtener información general sobre el ahorro de batería, consulte ahorro de batería (en las directrices del componente de hardware).

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
Library Taskschd.lib
Archivo DLL Taskschd.dll

Consulte también

IPrincipal

Programador de tareas