IPrincipal::get_LogonType-Methode (taskschd.h)

  • Artikel

Ruft die Sicherheitsanmeldungsmethode ab, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind, oder legt diese fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_LogonType(
  TASK_LOGON_TYPE *pLogon
);

Parameter

pLogon

Rückgabewert

Keine

Bemerkungen

Diese Eigenschaft ist nur gültig, wenn ein Benutzerbezeichner von der UserId-Eigenschaft angegeben wird.

Beim Lesen oder Schreiben von XML für eine Aufgabe wird der Anmeldetyp im <LogonType-Element> des Taskplanerschemas angegeben.

Bei einer Aufgabe, die eine Meldungsfeldaktion enthält, wird das Meldungsfeld angezeigt, wenn die Aufgabe aktiviert ist und der Vorgang über einen interaktiven Anmeldetyp verfügt. Um den Vorgangsanmeldungstyp auf interaktiv festzulegen, geben Sie TASK_LOGON_INTERACTIVE_TOKEN oder TASK_LOGON_GROUP in der LogonType-Eigenschaft des Aufgabenprinzipals oder im logonType-Parameter von ITaskFolder::RegisterTask oder ITaskFolder::RegisterTaskDefinition an.

Wenn der Akkusparmodus aktiviert ist, werden Windows Task Scheduler-Aufgaben nur ausgelöst, wenn die Aufgabe folgendes ist:

  • Sie ist nicht so festgelegt, dass die Aufgabe nur gestartet wird, wenn sich der Computer im Leerlauf befindet... (für die Aufgabe wird IdleSettings nicht verwendet)
  • Sie ist nicht so festgelegt, dass während der automatischen Wartung ausgeführt wird (für die Aufgabe wird MaintenanceSettings nicht verwendet)
  • Sie ist auf Nur ausführen, wenn der Benutzer angemeldet ist festgelegt (Aufgabe LogonType ist TASK_LOGON_INTERACTIVE_TOKEN oder TASK_LOGON_GROUP)
Alle anderen Trigger werden verzögert, bis der Akkusparmodus ausgeschaltet ist. Weitere Informationen zum Zugriff auf den Akkusparmodus in Ihrer Anwendung finden Sie unter SYSTEM_POWER_STATUS. Allgemeine Informationen zum Akkusparmodus finden Sie unter Akkusparmodus (in den Richtlinien für Hardwarekomponenten).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile taskschd.h
Bibliothek Taskschd.lib
DLL Taskschd.dll

Weitere Informationen

IPrincipal

Aufgabenplanung