Função GdiGetPageHandle (winppi.h)

A função GdiGetPageHandle retorna um identificador para a página especificada em um trabalho de impressão.

Sintaxe

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

Parâmetros

SpoolFileHandle

Identificador de arquivo de spool fornecido pelo chamador, obtido por uma chamada anterior para GdiGetSpoolFileHandle.

Page

Número de página fornecido pelo chamador.

pdwPageType

Ponteiro fornecido pelo chamador para um local que recebe o tipo de página. Os tipos de página possíveis são mostrados na tabela a seguir:

Tipo de página	Significado
EMF_PP_FORM	A página é um formulário ou tem uma marca d'água. (Não há suporte no momento.)
EMF_PP_NORMAL	A página é uma página normal.

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE. Caso contrário, a função retornará FALSE e um código de erro poderá ser obtido chamando GetLastError.

Comentários

A função GdiGetPageHandle é exportada por gdi32.dll para uso dentro da função PrintDocumentOnPrintProcessor de um processador de impressão.

Os processadores de impressão devem obter um identificador de página antes de chamar GdiPlayPageEMF para desenhar uma página. Se um valor page for especificado que seja muito grande, a função retornará ERROR_NO_MORE_ITEMS.

Para obter informações adicionais, consulte Usando funções GDI em processadores de impressão.

Requisitos

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	winppi.h (inclua Winppi.h)
Biblioteca	Gdi32.Lib
DLL	Gdi32.dll