Compartilhar via

Função AddPrintDeviceObject (winsplp.h)

  • Artigo

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, em Windows 8 e 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 do provedor de impressão AddPrintDeviceObject cria um objeto de dispositivo para uma fila do provedor de impressão.

Sintaxe

HRESULT AddPrintDeviceObject(
  [in]  HANDLE hPrinter,
  [out] HANDLE *phDeviceObject
);

Parâmetros

[in] hPrinter

Um HANDLE para uma impressora aberta. Esse deve ser um HANDLE retornado pelas funções de spooler AddPrinter ou OpenPrinter .

[out] phDeviceObject

Um HANDLE para o objeto do dispositivo, se ele tiver sido criado com êxito.

Retornar valor

A função AddPrintDeviceObject retornará S_OK, se o objeto do dispositivo tiver sido criado com êxito. Caso contrário, retornará um erro.

Comentários

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 deve chamar essa função para cada Impressora instalada anteriormente pertencente ao 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
Plataforma de Destino Área de Trabalho
Cabeçalho winsplp.h (inclua Winspool.h)
Biblioteca WinSpool.lib
DLL WinSpool.drv

Confira também

RemovePrintDeviceObject