Funzione GdiGetPageHandle (winppi.h)

Articolo
02/07/2025

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 di spooling 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 illustrati nella tabella seguente:

Tipo di pagina	Significato
EMF_PP_FORM	La pagina è una maschera o ha una filigrana. (Attualmente non 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 FALSEe è possibile ottenere un codice di errore chiamando GetLastError.

Osservazioni

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 in Processori di stampa.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	winppi.h (include Winppi.h)
libreria	Gdi32.Lib
dll	Gdi32.dll

Condividi tramite