NetScheduleJobDel-Funktion (lmat.h)
[NetScheduleJobDel ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen.
]
Die NetScheduleJobDel-Funktion löscht einen Bereich von Aufträgen, die für die Ausführung auf einem Computer in der Warteschlange stehen. Diese Funktion erfordert, dass der Zeitplandienst auf dem Computer gestartet wird, an den die Auftragslöschanforderung gesendet wird.
Syntax
NET_API_STATUS NET_API_FUNCTION NetScheduleJobDel(
[in, optional] LPCWSTR Servername,
[in] DWORD MinJobId,
[in] DWORD MaxJobId
);
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] MinJobId
Der Mindestauftragsbezeichner. Aufträge mit einem Auftragsbezeichner, der kleiner als MinJobId ist, werden nicht gelöscht.
[in] MaxJobId
Der maximale Auftragsbezeichner. Aufträge mit einem Auftragsbezeichner, der größer als MaxJobId ist, werden nicht gelöscht.
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 gelöscht wird, diese Funktion erfolgreich ausführen. Wenn der Servername, der in der Zeichenfolge übergeben wird, auf die der Parameter Servername verweist, ein Remoteserver ist, können nur Mitglieder der lokalen Gruppe Administratoren auf dem Server diese Funktion erfolgreich ausführen.
Wenn der folgende Registrierungswert über das am wenigsten signifikante Bit festgelegt ist (z. B. 0x00000001), können Benutzer, die zur Gruppe Serveroperatoren gehören, diese Funktion ebenfalls erfolgreich ausführen.
HKLM\System\CurrentControlSet\Control\Lsa\SubmitControl
Rufen Sie die NetScheduleJobEnum-Funktion auf, um den Auftragsbezeichner für einen oder mehrere geplante Aufträge abzurufen.
Die NetScheduleJobDel-Funktion löscht alle Aufträge, deren Auftragsbezeichner im Bereich MinJobId bis MaxJobId liegen.
Um alle geplanten Aufträge auf dem Server zu löschen, können Sie NetScheduleJobDel aufrufen, indem Sie MinJobId gleich 0 und MaxJobId gleich – 1 angeben. Um einen Auftrag zu löschen, geben Sie den Auftragsbezeichner sowohl für den MinJobId-Parameter als auch für den MaxJobId-Parameter an.
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 |