GetNetScheduleAccountInformation-Funktion (atacct.h)

  • Artikel

[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

Weitere Informationen

SetNetScheduleAccountInformation