Função RemovePrintDeviceObject (winsplp.h)
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 |