ITaskFolder::RegisterTaskDefinition-Methode (taskschd.h)
Registriert (erstellt) einen Task an einem angegebenen Speicherort mithilfe der ITaskDefinition-Schnittstelle , um einen Vorgang zu definieren.
Syntax
HRESULT RegisterTaskDefinition(
[in] BSTR path,
[in] ITaskDefinition *pDefinition,
[in] LONG flags,
[in] VARIANT userId,
[in] VARIANT password,
[in] TASK_LOGON_TYPE logonType,
[in, optional] VARIANT sddl,
[out] IRegisteredTask **ppTask
);
Parameter
[in] path
Der Name der Aufgabe. Wenn dieser Wert NULL ist, wird der Task im Stammtaskordner registriert, und der Vorgangsname ist ein GUID-Wert, der vom Taskplanerdienst erstellt wird.
Ein Aufgabenname kann nicht mit einem Leerzeichen beginnen oder enden. Das Zeichen "." kann nicht verwendet werden, um den aktuellen Aufgabenordner und den "." anzugeben. Zeichen können nicht verwendet werden, um den übergeordneten Aufgabenordner im Pfad anzugeben.
[in] pDefinition
Die Definition der registrierten Aufgabe.
[in] flags
Eine TASK_CREATION Konstante.
[in] userId
Die Benutzeranmeldeinformationen, die zum Registrieren der Aufgabe verwendet werden. Falls vorhanden, haben diese Anmeldeinformationen Vorrang vor den Anmeldeinformationen, die im Aufgabendefinitionsobjekt angegeben sind, auf das der pDefinition-Parameter verweist.
[in] password
Das Kennwort für die Benutzer-ID, die zum Registrieren der Aufgabe verwendet wird. Wenn der TASK_LOGON_SERVICE_ACCOUNT Anmeldetyp verwendet wird, muss das Kennwort ein leerer VARIANT-Wert sein, z. B. VT_NULL oder VT_EMPTY.
[in] logonType
Definiert, welche Anmeldetechnik zum Ausführen der registrierten Aufgabe verwendet wird.
[in, optional] sddl
Der Sicherheitsdeskriptor, der der registrierten Aufgabe zugeordnet ist. Sie können die Zugriffssteuerungsliste (Access Control List, ACL) im Sicherheitsdeskriptor für eine Aufgabe angeben, um bestimmten Benutzern und Gruppen den Zugriff auf eine Aufgabe zu erlauben oder zu verweigern.
[out] ppTask
Eine IRegisteredTask-Schnittstelle , die die neue Aufgabe darstellt.
Übergeben Sie einen Verweis auf einen NULL-IRegisteredTask-Schnittstellenzeiger. Das Verweisen auf einen Nicht-NULL-Zeiger kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode/-wert | BESCHREIBUNG |
---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Der Zugriff wird verweigert, um eine Verbindung mit dem Aufgabenplanerdienst herzustellen. |
|
Die Anwendung verfügt nicht über genügend Arbeitsspeicher, um den Vorgang abzuschließen, oder der Benutzer oder das Kennwort verfügt über mindestens einen NULL - und einen Ungleich-NULL-Wert . |
|
Die Aufgabe ist registriert, kann aber möglicherweise nicht gestartet werden. Batchanmeldungsberechtigungen müssen für den Aufgabenprinzipal aktiviert sein. |
|
Der Task ist registriert, aber nicht alle angegebenen Trigger starten den Task. |
Hinweise
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.
Nur ein Mitglied der Gruppe Administratoren kann eine Aufgabe mit einem Starttrigger erstellen.
Sie können eine Aufgabe erfolgreich mit einer Gruppe registrieren, die im userId-Parameter angegeben ist und TASK_LOGON_INTERACTIVE_TOKEN im logonType-Parameter von ITaskFolder::RegisterTask oder ITaskFolder::RegisterTaskDefinition angegeben, aber der Task wird nicht ausgeführt.
Das Gemeinsame Übergeben der werte TASK_VALIDATE_ONLY und TASK_IGNORE_REGISTRATION_TRIGGERS an den flags-Parameter ist ein ungültiges Argument.
Die ITaskFolder::RegisterTaskDefinition-Methode gibt einen Fehler 80070534 zurück, wenn sie vom Systemkonto aufgerufen wird, wobei der Benutzerparametergleich NULL, der Kennwortparametergleich NULL und der logonType-Parameter gleich TASK_LOGON_SERVICE_ACCOUNT ist.
Wenn ein Task ein Netzwerk definiert, das in den NetworkSettings-Einstellungen der Aufgabe nicht vorhanden ist, gibt die ITaskFolder::RegisterTaskDefinition-Methode beim Registrieren der Aufgabe einen Fehler 0x8000ffff zurück.
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für