IPrincipal::get_LogonType-Methode (taskschd.h)
Dient zum Abrufen oder Festlegen der Sicherheitsanmeldungsmethode, die zum Ausführen der Aufgaben erforderlich ist, die dem Prinzipal zugeordnet sind.
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 eine Benutzerbezeichner von der UserId-Eigenschaft angegeben wird.
Beim Lesen oder Schreiben von XML für einen Vorgang wird der <Anmeldetyp im LogonType-Element> des Taskplanerschemas angegeben.
Für eine Aufgabe, die eine Meldungsfeldaktion enthält, wird das Meldungsfeld angezeigt, wenn die Aufgabe aktiviert wird und der Vorgang einen interaktiven Anmeldetyp aufweist. Um den vorgangslogontyp als 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 Akkusparvorgang aktiviert ist, werden Windows-Aufgabenplaneraufgaben 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
| 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 |