Função RemovePrintDeviceObject (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 RemovePrintDeviceObject remove um objeto de dispositivo de uma fila de provedor de impressão.
Sintaxe
HRESULT RemovePrintDeviceObject(
[in] HANDLE hDeviceObject
);
Parâmetros
[in] hDeviceObject
O HANDLE para o objeto do dispositivo a ser removido. Esse deve ser um objeto de dispositivo que foi criado com AddPrintDeviceObject.
Valor de retorno
A função RemovePrintDeviceObject retornará S_OK, se o objeto do dispositivo tiver sido removido com êxito. Caso contrário, 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 uma chamada para RemovePrintDeviceObject tiver sido concluída.
Observações
Chame RemovePrintDeviceObject para remover o objeto do dispositivo de uma impressora que foi excluída. Quando os serviços do spooler param, todos os objetos do dispositivo são excluídos automaticamente, portanto, não é necessário chamar RemovePrintDeviceObject para cada objeto de dispositivo de impressora.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winspool.h) |
| biblioteca | WinSpool.lib |
| de DLL | WinSpool.drv |