GdiGetSpoolFileHandle-Funktion (winppi.h)

  • Artikel

Die GdiGetSpoolFileHandle-Funktion gibt ein Handle an die EMF-Datei eines Druckauftrags zurück.

Syntax

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

Parameter

pwszPrinterName

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die den Namen des Zieldruckers darstellt. Weitere Informationen finden Sie im abschnitt "Hinweise".

pDevmode

Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW-Struktur . Weitere Informationen finden Sie im abschnitt "Hinweise".

pwszDocName

Vom Aufrufer bereitgestellter Zeiger auf den Dokumentnamen des Druckauftrags. Weitere Informationen finden Sie im abschnitt "Hinweise".

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ein Spooldateihandle zurück. Andernfalls gibt die Funktion NULL zurück.

Hinweise

Die GdiGetSpoolFileHandle-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.

Wenn ein Druckprozessor GdiGetSpoolFileHandle aufruft, sollte er Argumente bereitstellen, wie in der folgenden Tabelle dargestellt.

Parameter Argument
pwszPrinterName Zeiger auf den Druckernamen, der von der OpenPrintProcessor-Funktion des Druckprozessors empfangen wird.
pDevmode Zeiger auf die DEVMODEW-Struktur in der PRINTPROCESSOROPENDATA-Struktur , die von der OpenPrintProcessor-Funktion des Druckprozessors empfangen wird.
pwszDocName Dokumentnamezeiger, der von der PrintDocumentOnPrintProcessor-Funktion des Druckprozessors empfangen wird.

Ein Druckprozessor muss die GdiGetSpoolFileHandle-Funktion aufrufen, bevor andere GDI-Druckfunktionen aufgerufen werden, da das zurückgegebene Handle an die anderen Funktionen übergeben werden muss. Die Funktion ruft OpenPrinter auf, um eine Verbindung mit dem Drucker zu öffnen, und CreateDC, um einen Gerätekontext für das Zeichnen zu erstellen. Der Druckprozessor kann das Handle des Gerätekontexts abrufen, indem er GdiGetDC aufruft.

Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header winppi.h (winppi.h einschließen)
Bibliothek Gdi32.Lib
DLL Gdi32.dll

Weitere Informationen

GdiDeleteSpoolFileHandle