GdiGetPageHandle-Funktion (winppi.h)

Artikel
03/01/2024

Die GdiGetPageHandle-Funktion gibt ein Handle an die angegebene Seite innerhalb eines Druckauftrags zurück.

Syntax

HANDLE GdiGetPageHandle(
  HANDLE  SpoolFileHandle,
  DWORD   Page,
  LPDWORD pdwPageType
);

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestelltes Spooldateihandle, das durch einen vorherigen Aufruf von GdiGetSpoolFileHandle abgerufen wurde.

Page

Vom Aufrufer bereitgestellte Seitennummer.

pdwPageType

Vom Aufrufer bereitgestellter Zeiger auf einen Speicherort, der den Seitentyp empfängt. Die möglichen Seitentypen sind in der folgenden Tabelle aufgeführt:

Seitentyp	Bedeutung
EMF_PP_FORM	Die Seite ist ein Formular oder hat ein Wasserzeichen. (Derzeit nicht unterstützt.)
EMF_PP_NORMAL	Die Seite ist eine normale Seite.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls gibt die Funktion FALSE zurück, und ein Fehlercode kann durch Aufrufen von GetLastError abgerufen werden.

Hinweise

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

Druckprozessoren müssen ein Seitenhandle abrufen, bevor GdiPlayPageEMF aufgerufen wird , um eine Seite zu zeichnen. Wenn ein Page-Wert angegeben wird, der zu groß ist, gibt die Funktion ERROR_NO_MORE_ITEMS zurück.

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

Freigeben über