Função GdiGetPageCount (winppi.h)

A função GdiGetPageCount retorna o número de páginas em um trabalho de impressão.

Sintaxe

DWORD GdiGetPageCount(
  HANDLE SpoolFileHandle
);

Parâmetros

SpoolFileHandle

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

Retornar valor

Se a operação for bem-sucedida, a função retornará o número de páginas no trabalho de impressão atual. Caso contrário, a função retornará zero.

Comentários

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

A função GdiGetPageCount não retorna até que todas as páginas tenham sido spooled, mesmo que o administrador do servidor de impressão tenha especificado que os trabalhos de impressão devem ser impressos durante o spooling. Portanto, essa função não deve ser usada, a menos que seja necessário obter a contagem total de páginas antes que o processamento de documentos possa começar, como para imprimir páginas em ordem inversa.

Normalmente, um método melhor para determinar a contagem de páginas é contar o número de chamadas feitas para GdiGetPageHandle.

Para obter informações adicionais sobre esse conjunto de funções, 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