GdiGetPageHandle-Funktion (winppi.h)

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:

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