NetScheduleJobGetInfo-Funktion (lmat.h)

Artikel
08/24/2023

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

]

Die NetScheduleJobGetInfo-Funktion ruft Informationen zu einem bestimmten Auftrag ab, der auf einem angegebenen Computer in die Warteschlange gestellt wird. Für diese Funktion muss der Zeitplandienst gestartet werden.

Syntax

NET_API_STATUS NET_API_FUNCTION NetScheduleJobGetInfo(
  [in, optional] LPCWSTR Servername,
  [in]           DWORD   JobId,
  [out]          LPBYTE  *PointerToBuffer
);

Parameter

[in, optional] Servername

Ein Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] JobId

Ein Wert, der den Bezeichner des Auftrags angibt, für den Informationen abgerufen werden sollen.

[out] PointerToBuffer

Ein Zeiger auf den Puffer, der die AT_INFO Struktur empfängt, die den angegebenen Auftrag beschreibt. Dieser Puffer wird vom System zugewiesen und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Normalerweise können nur Mitglieder der lokalen Administratorgruppe auf dem Computer, auf dem der Zeitplanauftrag aufgelistet wird, diese Funktion erfolgreich ausführen. Wenn der servername übergebene Servername in der Zeichenfolge, auf die vom Parameter Servername verwiesen wird, ein Remoteserver ist, können nur Mitglieder der lokalen Gruppe Administratoren auf dem Server diese Funktion erfolgreich ausführen.

Wenn für den folgenden Registrierungswert das am wenigsten signifikante Bit festgelegt ist (z. B. 0x00000001), können Benutzer, die zur Gruppe Serveroperatoren gehören, diese Funktion auch erfolgreich ausführen.

HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmat.h (include Lmat.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll