ScheduleJob-Funktion

Die ScheduleJob-Funktion fordert an, dass der Druckspooler einen angegebenen Druckauftrag für den Druck plant.

Syntax

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

Parameter

hPrinter [in]

Ein Ziehpunkt für den Drucker für den Druckauftrag. Dies muss ein lokaler Drucker sein, der als Spooldrucker konfiguriert ist. Wenn hPrinter ein Handle für eine Remotedruckerverbindung ist oder der Drucker für den direkten Druck konfiguriert ist, schlägt die ScheduleJob-Funktion fehl. Verwenden Sie die OpenPrinter - oder AddPrinter-Funktion , um einen Druckerhandle abzurufen.

hPrinter muss das gleiche Druckerhandle sein, das im Aufruf von AddJob angegeben wurde, der den Druckauftragsbezeichner dwJobID abgerufen hat.

dwJobID [in]

Der zu planende Druckauftrag. Sie erhalten diesen Druckauftragsbezeichner, indem Sie die AddJob-Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Bemerkungen

Hinweis

Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückgegeben wird. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierungsfaktoren ab, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu führen, dass die Anwendung nicht mehr reagiert.

Sie müssen die AddJob-Funktion erfolgreich aufrufen, bevor Sie die ScheduleJob-Funktion aufrufen. AddJob ruft den Druckauftragsbezeichner ab, den Sie als dwJobID an ScheduleJob übergeben. Beide Aufrufe müssen denselben Wert für hPrinter verwenden.

Die ScheduleJob-Funktion sucht nach einer gültigen Spooldatei. Wenn eine ungültige Spooldatei vorhanden ist oder leer ist, löscht ScheduleJob sowohl die Spooldatei als auch den entsprechenden Druckauftragseintrag im Druckspooler.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Winspool.h (Einschließen von Windows.h)
Bibliothek	Winspool.lib
DLL	Spoolss.dll

Siehe auch

Drucken

Druckspooler-API-Funktionen

Addjob

OpenPrinter