NetScheduleJobDel-Funktion (lmat.h)

Artikel
08/24/2023

[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