NetScheduleJobEnum-Funktion (lmat.h)

Artikel
08/24/2023

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

]

Die NetScheduleJobEnum-Funktion listet die Aufträge auf, die auf einem angegebenen Computer in die Warteschlange gestellt werden. Für diese Funktion muss der Zeitplandienst gestartet werden.

Syntax

NET_API_STATUS NET_API_FUNCTION NetScheduleJobEnum(
  [in, optional] LPCWSTR Servername,
  [out]          LPBYTE  *PointerToBuffer,
  [in]           DWORD   PrefferedMaximumLength,
  [out]          LPDWORD EntriesRead,
  [out]          LPDWORD TotalEntries,
  [in, out]      LPDWORD ResumeHandle
);

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.

[out] PointerToBuffer

Ein Zeiger auf den Puffer, der die Daten empfängt. Die Rückgabeinformationen sind ein Array von AT_ENUM Strukturen. Der Puffer wird vom System zugewiesen und muss mithilfe eines einzelnen Aufrufs der NetApiBufferFree-Funktion freigegeben werden. Beachten Sie, dass Sie den Puffer auch dann freigeben müssen, wenn die Funktion mit ERROR_MORE_DATA fehlschlägt.

[in] PrefferedMaximumLength

Ein Wert, der die bevorzugte maximale Länge der zurückgegebenen Daten in Bytes angibt. Wenn Sie MAX_PREFERRED_LENGTH angeben, weist die Funktion den für die Daten erforderlichen Arbeitsspeicher zu. Wenn Sie in diesem Parameter einen anderen Wert angeben, kann die Anzahl der Von der Funktion zurückgegebenen Bytes eingeschränkt werden. Wenn die Puffergröße nicht ausreicht, um alle Einträge aufzunehmen, gibt die Funktion ERROR_MORE_DATA zurück. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

[out] EntriesRead

Ein Zeiger auf einen Wert, der die Anzahl der tatsächlich aufgelisteten Elemente empfängt.

[out] TotalEntries

Ein Zeiger auf einen Wert, der die Gesamtanzahl von Einträgen empfängt, die aus der aktuellen Position des Fortsetzens hätten aufgezählt werden können. Beachten Sie, dass Anwendungen diesen Wert nur als Hinweis betrachten sollten.

[in, out] ResumeHandle

Ein Zeiger auf einen Wert, der ein Resume-Handle enthält, das zum Fortsetzen einer Auftragsaufzählung verwendet wird. Das Handle sollte beim ersten Aufruf 0 sein und für nachfolgende Aufrufe unverändert bleiben. Wenn dieser Parameter NULL ist, wird kein Resume-Handle gespeichert.

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

Jeder zurückgegebene Eintrag enthält eine AT_ENUM-Struktur . Der Wert des JobId-Members kann beim Aufrufen von Funktionen verwendet werden, die einen Auftragsbezeichnerparameter erfordern, z. B. die NetScheduleJobDel-Funktion .

Anforderungen

Anforderung	Wert
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