Compartilhar via


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