Função RemovePrintDeviceObject (winsplp.h)

  • Artigo

Aviso

A partir do Windows 10, as APIs que dão suporte a provedores de impressão de terceiros foram 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 RemovePrintDeviceObject remove um objeto de dispositivo de uma fila do provedor de impressão.

Sintaxe

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

Parâmetros

[in] hDeviceObject

O HANDLE para o objeto de dispositivo a ser removido. Esse deve ser um objeto de dispositivo que foi criado com AddPrintDeviceObject.

Retornar valor

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

Por exemplo, essa função poderá retornar HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), se um identificador de objeto de dispositivo inválido tiver sido usado para chamar a função. E observe que, independentemente do valor retornado, o HANDLE do objeto do dispositivo se torna inválido após a conclusão de uma chamada para RemovePrintDeviceObject .

Comentários

Chame RemovePrintDeviceObject para remover o objeto de dispositivo de uma impressora que foi excluída. Quando os serviços de spooler param, todos os objetos de dispositivo são excluídos automaticamente, portanto, não é necessário chamar RemovePrintDeviceObject para cada objeto de dispositivo de impressora.

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

AddPrintDeviceObject