Função UpdatePrintDeviceObject (winsplp.h)

  • Artigo

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

Confira também

AddPrintDeviceObject

PRINTER_INFO_2