IPrincipal::get_LogonType-Methode (taskschd.h)
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)
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 |