Funzione GdiGetPageHandle (winppi.h)

  • Articolo

La funzione GdiGetPageHandle restituisce un handle alla pagina specificata all'interno di un processo di stampa.

Sintassi

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

Parametri

SpoolFileHandle

Handle di file spool fornito dal chiamante, ottenuto da una chiamata precedente a GdiGetSpoolFileHandle.

Page

Numero di pagina fornito dal chiamante.

pdwPageType

Puntatore fornito dal chiamante a una posizione che riceve il tipo di pagina. I tipi di pagina possibili sono visualizzati nella tabella seguente:

Tipo di pagina Significato
EMF_PP_FORM La pagina è una maschera o ha una filigrana. (Non attualmente supportato).
EMF_PP_NORMAL La pagina è una pagina normale.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSE e un codice di errore può essere ottenuto chiamando GetLastError.

Commenti

La funzione GdiGetPageHandle viene esportata da gdi32.dll per l'uso all'interno della funzione PrintDocumentOnPrintProcessor di un processore di stampa.

I processori di stampa devono ottenere un handle di pagina prima di chiamare GdiPlayPageEMF per disegnare una pagina. Se viene specificato un valore page troppo grande, la funzione restituisce ERROR_NO_MORE_ITEMS.

Per altre informazioni, vedere Uso di funzioni GDI nei processori di stampa.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione winppi.h (include Winppi.h)
Libreria Gdi32.Lib
DLL Gdi32.dll