Função AddPrintDeviceObject (winsplp.h)
Aviso
A partir do Windows 10, as APIs que dão suporte a provedores de impressão de terceiros são preteridas. A Microsoft não recomenda nenhum investimento em provedores de impressão de terceiros. Além disso, no Windows 8 e em produtos mais recentes em que o modelo de driver de impressão v4 está disponível, os provedores de impressão de terceiros podem não criar ou gerenciar filas que usam drivers de impressão v4.
A função AddPrintDeviceObject provedor de impressão cria um objeto de dispositivo para uma fila de provedor de impressão.
Sintaxe
HRESULT AddPrintDeviceObject(
[in] HANDLE hPrinter,
[out] HANDLE *phDeviceObject
);
Parâmetros
[in] hPrinter
Um IDENTIFICADOR para uma impressora aberta. Esse deve ser um HANDLE retornado pelas funções AddPrinter ou OpenPrinter spooler.
[out] phDeviceObject
Um HANDLE para o objeto do dispositivo, se ele tiver sido criado com êxito.
Valor de retorno
A função AddPrintDeviceObject retornará S_OK, se o objeto do dispositivo tiver sido criado com êxito. Caso contrário, ele retornará um erro.
Observações
A função AddPrintDeviceObject deve ser chamada nas seguintes situações:
O usuário instala uma impressora
O provedor de impressão deve chamar essa função depois de instalar a impressora.
A função deve ser chamada representando o usuário que está instalando a impressora.
O provedor de impressão é inicializado após o início do serviço spooler
O provedor de impressão deve chamar essa função para cada Impressora instalada anteriormente de propriedade do provedor. Durante esse tempo, AddPrintDeviceObject não precisa representar o contexto do usuário quando ele é chamado.
Qualquer objeto de dispositivo adicionado usando AddPrintDeviceObject persistirá até que você o remova usando RemovePrintDeviceObject ou até que o serviço spooler seja reiniciado. E quando os serviços do spooler param, todos os objetos do dispositivo são excluídos automaticamente.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winspool.h) |
| biblioteca | WinSpool.lib |
| de DLL | WinSpool.drv |