Função GdiGetSpoolFileHandle (winppi.h)

Artigo
02/07/2025

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 deDEVMODEW. 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.

Valor de retorno

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.

Observações

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 de DEVMODEW contida na estrutura dePRINTPROCESSOROPENDATA, 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 outras funções 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
da Plataforma de Destino	Universal
cabeçalho	winppi.h (inclua Winppi.h)
biblioteca	Gdi32.Lib
de DLL	Gdi32.dll

Consulte também

GdiDeleteSpoolFileHandle

Partilhar via