Função GdiGetSpoolFileHandle (winppi.h)

  • Artigo

A função GdiGetSpoolFileHandle retorna um identificador para o arquivo EMF de um trabalho de impressão.

Sintaxe

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

Parâmetros

pwszPrinterName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres que representa o nome da impressora de destino. Consulte a seção Comentários a seguir.

pDevmode

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW . Consulte a seção Comentários a seguir.

pwszDocName

Ponteiro fornecido pelo chamador para o nome do documento do trabalho de impressão. Consulte a seção Comentários a seguir.

Retornar valor

Se a operação for bem-sucedida, a função retornará um identificador de arquivo de spool. Caso contrário, a função retornará NULL.

Comentários

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

Quando um processador de impressão chama GdiGetSpoolFileHandle, ele deve fornecer argumentos conforme ilustrado na tabela a seguir.

Parâmetro Argumento
pwszPrinterName Ponteiro para o nome da impressora recebido pela função OpenPrintProcessor do processador de impressão.
pDevmode Ponteiro para a estrutura DEVMODEW contida na estrutura PRINTPROCESSOROPENDATA , recebida pela função OpenPrintProcessor do processador de impressão.
pwszDocName Ponteiro de nome do documento recebido pela função PrintDocumentOnPrintProcessor do processador de impressão.

Um processador de impressão deve chamar a função GdiGetSpoolFileHandle antes de chamar qualquer outra função de impressão GDI, pois o identificador retornado deve ser passado para as outras funções. A função chama OpenPrinter para abrir uma conexão com a impressora e CreateDC para criar um contexto de dispositivo para desenho. O processador de impressão pode obter o identificador do contexto do dispositivo chamando GdiGetDC.

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

Confira também

GdiDeleteSpoolFileHandle