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, 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 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 retornado pelo AddPrinter ou funções de spooler 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.
Valor de retorno
A função UpdatePrintDeviceObject retornará S_OK, se as propriedades do objeto do dispositivo foram atualizadas com êxito. Caso contrário, 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.
Observações
A estrutura PRINTER_INFO_2 é um bom exemplo do tipo de propriedades que updatePrintDeviceObject pode atualizar.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winspool.h) |
| biblioteca | WinSpool.lib |
| de DLL | WinSpool.drv |