ITaskFolder::RegisterTask-Methode (taskschd.h)
Registriert (erstellt) eine neue Aufgabe im Ordner mithilfe von XML, um die Aufgabe zu definieren.
Syntax
HRESULT RegisterTask(
[in] BSTR path,
[in] BSTR xmlText,
[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 Vorgangsname. Wenn dieser Wert NULL-ist, wird die Aufgabe im Stammaufgabenordner registriert, und der Vorgangsname ist ein GUID-Wert, der vom Taskplanerdienst erstellt wird.
Ein Vorgangsname kann nicht mit einem Leerzeichen beginnen oder enden. Das Zeichen '.' kann nicht zum Angeben des aktuellen Aufgabenordners und des '.' verwendet werden. Zeichen können nicht verwendet werden, um den übergeordneten Aufgabenordner im Pfad anzugeben.
[in] xmlText
Eine XML-formatierte Definition der Aufgabe.
Die folgenden Themen enthalten Aufgaben, die mithilfe von XML definiert wurden.
- Zeitauslöser (XML-Beispiel)
- Ereignistrigger (XML-Beispiel)
- Daily Trigger(XML)-
- Registrierungstrigger (XML-Beispiel)
- Wöchentlicher Trigger (XML-Beispiel)
- Anmeldetrigger (XML-Beispiel)
- Starttrigger (XML-Beispiel)
[in] flags
Eine TASK_CREATION Konstante.
[in] userId
Die Zum Registrieren der Aufgabe verwendeten Benutzeranmeldeinformationen.
[in] password
Das Kennwort für die userId, die zum Registrieren der Aufgabe verwendet wurde. Wenn der TASK_LOGON_SERVICE_ACCOUNT Anmeldetyp verwendet wird, muss das Kennwort ein leerer VARIANT Wert wie VT_NULL oder VT_EMPTYsein.
[in] logonType
Ein Wert, der 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) in der Sicherheitsbeschreibung für eine Aufgabe angeben, um bestimmte Benutzer und Gruppen den Zugriff auf eine Aufgabe zuzulassen 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.
Zurückgeben von Code/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 hat oder Kennwort mindestens einen Null- und einen Nicht-Null-Wert. |
|
Die Aufgabe ist registriert, kann jedoch nicht gestartet werden. Batchanmeldungsberechtigungen müssen für den Aufgabenprinzipal aktiviert werden. |
|
Der Vorgang wird registriert, aber nicht alle angegebenen Trigger starten den Vorgang. |
Bemerkungen
Bei einer Aufgabe, die eine Meldungsfeldaktion enthält, wird das Meldungsfeld angezeigt, wenn die Aufgabe aktiviert ist und die Aufgabe einen interaktiven Anmeldetyp aufweist. Wenn Sie den Aufgabenanmeldungstyp als interaktiv festlegen möchten, 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::RegisterTaskDefinitionan.
Nur ein Mitglied der Gruppe "Administratoren" kann eine Aufgabe mit einem Starttrigger erstellen.
Sie können eine Aufgabe erfolgreich bei einer gruppe registrieren, die im parameter
Das Übergeben der werte TASK_VALIDATE_ONLY und TASK_IGNORE_REGISTRATION_TRIGGERS an die Flags Parameter ist ein ungültiges Argument.
Wenn eine Aufgabe ein Netzwerk definiert, das nicht in den NetworkSettings- Einstellungen des Vorgangs vorhanden ist, gibt die ITaskFolder::RegisterTask--Methode fehler 0x8000ffff zurück, wenn die Aufgabe registriert ist.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | taskschd.h |
Library | Taskschd.lib |
DLL- | Taskschd.dll |