NetScheduleJobGetInfo-Funktion (lmat.h)
[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 |