Compartilhar via


Função EngGetPrinter (winddi.h)

A função EngGetPrinter recupera informações sobre a impressora especificada.

Sintaxe

ENGAPI BOOL EngGetPrinter(
  [in]            HANDLE  hPrinter,
  [in]            DWORD   dwLevel,
  [out, optional] LPBYTE  pPrinter,
  [in]            DWORD   cbBuf,
  [out]           LPDWORD pcbNeeded
);

Parâmetros

[in] hPrinter

Identificador para a impressora para a qual os dados devem ser recuperados. Esse é o identificador passado como o parâmetro hDriver de DrvEnablePDEV.

[in] dwLevel

Especifica a versão da estrutura para a qual pPrinter aponta. Esse parâmetro pode ter qualquer um dos seguintes valores:

Valor Estrutura retornada por meio de pPrinter
1 PRINTER_INFO_1
2 PRINTER_INFO_2
3 PRINTER_INFO_3
4 PRINTER_INFO_4
5 PRINTER_INFO_5

[out, optional] pPrinter

Ponteiro para o buffer de memória no qual a estrutura de informações da impressora, identificada por dwLevel, é carregada.

[in] cbBuf

Especifica o tamanho, em bytes, do buffer de memória apontado pelo pPrinter.

[out] pcbNeeded

Ponteiro para um local de memória que recebe o número de bytes copiados se a função for bem-sucedida ou o número de bytes necessários se cbBuf for muito pequeno.

Valor retornado

EngGetPrinter retorna TRUE após êxito; caso contrário, ele registra um erro e retorna FALSE. Para obter informações de erro, chame EngGetLastError.

Comentários

As estruturas PRINTER_INFO_X são definidas na documentação do SDK do Microsoft Windows.

Requisitos

   
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

DrvEnablePDEV