Função UpdatePrintDeviceObject (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, 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 UpdatePrintDeviceObject atualiza as propriedades de um objeto de dispositivo que está na fila do provedor de impressão.
Sintaxe
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
Parâmetros
[in] hPrinter
O HANDLE para uma impressora aberta. Esse deve ser um identificador que foi retornado pelas funções de spooler AddPrinter ou OpenPrinter .
[in] hDeviceObject
O HANDLE para o objeto do dispositivo a ser atualizado. Esse deve ser um objeto de dispositivo que foi criado com AddPrintDeviceObject.
Retornar valor
A função UpdatePrintDeviceObject retornará S_OK, se as propriedades do objeto do dispositivo forem atualizadas com êxito. Caso contrário, ela retornará um erro.
Por exemplo, essa função pode retornar HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), se a chamada de função foi feita com um HANDLE inválido ou o objeto do dispositivo foi removido antes da chamada de função ser feita.
Comentários
A estrutura PRINTER_INFO_2 é um bom exemplo do tipo de propriedades que UpdatePrintDeviceObject pode atualizar.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winsplp.h (inclua Winspool.h) |
| Biblioteca | WinSpool.lib |
| DLL | WinSpool.drv |