GetNetScheduleAccountInformation-Funktion (atacct.h)
[GetNetScheduleAccountInformation ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen.
]
Die GetNetScheduleAccountInformation-Funktion ruft den Namen des AT-Dienstkontos ab.
Syntax
HRESULT GetNetScheduleAccountInformation(
[in] LPCWSTR pwszServerName,
[in] DWORD ccAccount,
[out] WCHAR [] wszAccount
);
Parameter
[in] pwszServerName
Eine MIT NULL beendete Breitzeichenzeichenfolge für den Namen des Computers, dessen Kontoinformationen abgerufen werden.
[in] ccAccount
Die Anzahl der Zeichen, einschließlich des NULL-Abschlusszeichens, die wszAccount zugeordnet sind. Die maximal zulässige Länge für diesen Wert ist die maximale Domänennamenlänge plus die maximale Länge des Benutzernamens plus 2, ausgedrückt als DNLEN + UNLEN + 2. (Die letzten beiden Zeichen sind das Zeichen "" und der NULL-Abschlusszeichen.)
[out] wszAccount
Ein Array von Breitzeichen, einschließlich des NULL-Abschlusszeichens, das die Kontoinformationen empfängt.
Rückgabewert
Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass die Funktion erfolgreich war, und die Kontoinformationen werden in wszAccount zurückgegeben. Der Wert S_FALSE gibt an, dass die Funktion erfolgreich war, und das Konto ist das Lokale Systemkonto (in wszAccount werden keine Informationen zurückgegeben). Alle anderen Rückgabewerte weisen auf eine Fehlerbedingung hin.
Hinweise
Um die GetNetScheduleAccountInformation-Funktion erfolgreich aufzurufen, muss der Aufrufer Über Lesezugriff auf den Aufgabenordner verfügen, der in der Regel %windir%\tasks oder wie in der folgenden Registrierungseinstellung definiert ist:
HKLM\SOFTWARE\Microsoft\SchedulingAgent\TasksFolder
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 |