IScheduledWorkItem::SetAccountInformation-Methode (mstask.h)
[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]
Legt den Kontonamen und das Kennwort fest, die zum Ausführen des Arbeitselements verwendet werden.
Syntax
HRESULT SetAccountInformation(
[in] LPCWSTR pwszAccountName,
[in] LPCWSTR pwszPassword
);
Parameter
[in] pwszAccountName
Eine Zeichenfolge, die den null-beendeten Namen des Benutzerkontos enthält, in dem das Arbeitselement ausgeführt wird. Um das lokale Systemkonto anzugeben, verwenden Sie die leere Zeichenfolge L""". Verwenden Sie keine andere Zeichenfolge, um das lokale Systemkonto anzugeben. Weitere Informationen finden Sie in den Hinweisen.
[in] pwszPassword
Eine Zeichenfolge, die das Kennwort für das in pwszAccountName angegebene Konto enthält.
Legen Sie diesen Parameter auf NULL fest, wenn das lokale Systemkonto angegeben ist. Wenn Sie das TASK_FLAG_RUN_ONLY_IF_LOGGED_ON-Flag festlegen, können Sie pwszPassword auch für lokale oder Domänenbenutzerkonten auf NULL festlegen. Verwenden Sie die IScheduledWorkItem::SetFlags-Methode , um das Flag festzulegen.
Der Taskplaner speichert Kontoinformationen nur einmal für alle Aufgaben, die dasselbe Konto verwenden. Wenn das Kontokennwort für eine Aufgabe aktualisiert wird, verwenden alle Aufgaben, die dasselbe Konto verwenden, das aktualisierte Kennwort.
Wenn Sie das Kennwort verwendet haben, löschen Sie die Kennwortinformationen, indem Sie die SecureZeroMemory-Funktion aufrufen. Weitere Informationen zum Schutz von Kennwörtern finden Sie unter Behandeln von Kennwörtern.
Rückgabewert
Die SetAccountInformation-Methode gibt einen der folgenden Werte zurück. Beachten Sie, dass Fehler aus diesem Aufruf auch durch den nachfolgenden Aufruf von IPersistFile::Save zurückgegeben werden können.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der Aufrufer verfügt nicht über die Berechtigung zum Ausführen des Vorgangs. Weitere Informationen finden Sie in den Hinweisen. |
|
Die Argumente sind ungültig. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar. |
|
Sicherheitsdienste sind nur unter Windows Server 2003, Windows XP und Windows 2000 verfügbar. |
|
Der pwszPassword-Parameter wurde auf NULL festgelegt, aber das TASK_FLAG_RUN_ONLY_IF_LOGGED_ON-Flag wurde nicht festgelegt. |
|
Der pwszPassword-Parameter war falsch. In Windows Server 2003 überprüft der Taskplaner das Kennwort zum Zeitpunkt der Auftragserstellung (während eines Aufrufs von IPersistFile::Save). Beachten Sie, dass im Fall dieses Fehlers die Auftragsdatei weiterhin erstellt wird. |
Hinweise
Diese Methode gilt für Windows Server 2003, Windows XP und Windows 2000.
Wenn pwszAccountName das lokale Systemkonto angibt, muss der Aufrufer ein Administrator auf dem lokalen Computer oder eine Anwendung sein, die im lokalen Systemkonto ausgeführt wird. Andernfalls schlägt diese Methode fehl.
Das in pwszPassword angegebene Kennwort wird verwendet, um sich beim Konto anzumelden, wenn das Arbeitselement ausgeführt wird. Ein falsches Kennwort führt zu einem Fehler, wenn das Arbeitselement ausgeführt wird. In Windows Server 2003 überprüft der Taskplaner das Kennwort jedoch zum Zeitpunkt der Auftragserstellung (während eines Aufrufs von IPersistFile::Save).
In der Regel haben Kennwörter ein Ablaufdatum. Wenn Sie Aufgaben planen, die unbegrenzt ausgeführt werden, müssen Sie die Aufgabe aktualisieren, um das neue Kennwort widerzuspiegeln.
Beachten Sie, dass Fehler durch den ersten Aufruf von SetAccountInformation oder den nachfolgenden Aufruf von IPersistFile::Save zurückgegeben werden können.
Der Taskplanerdienst muss ausgeführt werden, damit dieser Aufruf erfolgreich ist. (SetAccountInformation führt zu einem Remoteprozeduraufruf (RPC) für den Taskplanerdienst, aber der RPC-Aufruf wird erst ausgeführt, wenn IPersistFile::Save aufgerufen wird.)
Der E_ACCESSDENIED Rückgabecode wird unter den folgenden Bedingungen zurückgegeben:
- Der Aufrufer hat keinen Schreibzugriff auf die Datei, die das geplante Arbeitselement darstellt.
- Das lokale Konto wurde angegeben (pwszAccountName wurde auf L") festgelegt, aber der Aufrufer ist weder Administrator auf dem lokalen Computer noch eine Anwendung, die im lokalen Systemkonto ausgeführt wird.
- In pwszPassword wurde ein NULL-Kennwort angegeben, aber der Aufrufer ist weder Administrator auf dem lokalen Computer noch wird er im lokalen Systemkonto ausgeführt.
- Die Anwendung wird unter einem anderen Benutzernamen als der im pwszAccountName-Parameter angegebene Benutzer ausgeführt.
Beispiele
Weitere Informationen und ein Beispiel zum Festlegen der Kontoinformationen einer Aufgabe finden Sie unter C/C++-Codebeispiel: Festlegen von Aufgabenkontoinformationen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mstask.h |
| Bibliothek | Mstask.lib |
| DLL | Mstask.dll |