SetNetScheduleAccountInformation-Funktion (atacct.h)

Artikel
02/23/2024

[SetNetScheduleAccountInformation ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen.

]

Die SetNetScheduleAccountInformation-Funktion legt den Namen und das Kennwort des AT-Dienstkontos fest. Der Name und das Kennwort des AT-Dienstkontos werden als Anmeldeinformationen für geplante Aufträge verwendet, die mit NetScheduleJobAdd erstellt wurden.

Syntax

HRESULT SetNetScheduleAccountInformation(
  [in] LPCWSTR pwszServerName,
  [in] LPCWSTR pwszAccount,
  [in] LPCWSTR pwszPassword
);

Parameter

[in] pwszServerName

Eine MIT NULL beendete breite Zeichenfolge für den Namen des Computers, dessen Kontoinformationen festgelegt werden.

[in] pwszAccount

Ein Zeiger auf eine mit NULL beendete breite Zeichenfolge für das Konto. Um das lokale Systemkonto anzugeben, legen Sie diesen Parameter auf NULL fest.

[in] pwszPassword

Ein Zeiger auf eine MIT NULL beendete breite Zeichenfolge für das Kennwort. Informationen zum Schützen von Kennwortinformationen finden Sie unter Behandeln von Kennwörtern.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass der Kontoname und das Kennwort erfolgreich festgelegt wurden. Jeder andere Wert gibt eine Fehlerbedingung an.

Wenn die Funktion fehlschlägt, sind einige der möglichen Rückgabewerte unten aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
E_ACCESSDENIED 0x080070005	Der Zugriff wurde verweigert. Dieser Fehler wird zurückgegeben, wenn der Aufrufer kein Mitglied der Gruppe Administratoren war. Dieser Fehler wird auch zurückgegeben, wenn der pwszAccount-Parameter nicht NULL war, was ein benanntes Konto und nicht das lokale Systemkonto angibt und der pwszPassword-Parameter für das im pwszAccount-Parameter angegebene Konto falsch war.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) 0x08007000d	Ungültige Daten. Dieser Fehler wird zurückgegeben, wenn der pwszPassword-ParameterNULL oder die Länge der pwszPassword-Parameterzeichenfolge zu lang war.
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	Das angegebene Konto kann nicht festgestellt werden. Dieser Fehler wird zurückgegeben, wenn der pwszAccount-Parameter nicht NULL war, was ein benanntes Konto und nicht das lokale Systemkonto angibt und der pwszAccount-Parameter nicht gefunden wurde.

Hinweise

SetNetScheduleAccountInformation gibt die Identität des Aufrufers an. Nur Mitglieder der lokalen Gruppe Administratoren auf dem Computer, auf dem die Zeitplankontoinformationen festgelegt werden, können diese Funktion erfolgreich ausführen. Beachten Sie, dass NULL-Kennwörter nicht zulässig sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	atacct.h
Bibliothek	Mstask.lib
DLL	Mstask.dll

Weitere Informationen

GetNetScheduleAccountInformation

Freigeben über