StartDocW-Funktion (wingdi.h)

Artikel
08/27/2023

Die StartDoc-Funktion startet einen Druckauftrag.

Syntax

int StartDocW(
  [in] HDC            hdc,
  [in] const DOCINFOW *lpdi
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext für den Druckauftrag.

[in] lpdi

Ein Zeiger auf eine DOCINFO-Struktur , die den Namen der Dokumentdatei und den Namen der Ausgabedatei enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert größer als 00. Dieser Wert ist der Druckauftragsbezeichner für das Dokument.

Wenn die Funktion fehlschlägt, ist der Rückgabewert kleiner oder gleich 0.

Hinweise

Hinweis Dies ist eine blockierende oder synchrone Funktion und wird möglicherweise nicht sofort zurückgegeben. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckserverkonfiguration und Druckertreiberimplementierung ab – Faktoren, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Wenn Sie diese Funktion über einen Thread aufrufen, der die Interaktion mit der Benutzeroberfläche verwaltet, kann die Anwendung nicht reagieren.

Anwendungen sollten die StartDoc-Funktion unmittelbar vor dem Start eines Druckauftrags aufrufen. Mit dieser Funktion wird sichergestellt, dass mehrseitige Dokumente nicht mit anderen Druckaufträgen durchsetzt werden.

Anwendungen können den von StartDoc zurückgegebenen Wert verwenden, um die Priorität eines Druckauftrags abzurufen oder festzulegen. Rufen Sie die GetJob - oder SetJob-Funktion auf, und geben Sie diesen Wert als eines der erforderlichen Argumente an.

Beispiele

Ein Beispielprogramm, das diese Funktion verwendet, finden Sie unter Vorgehensweise: Drucken mithilfe der GDI-Druck-API.

Hinweis

Der wingdi.h-Header definiert StartDoc als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll