UpdatePrintDeviceObject 関数 (winsplp.h)
警告
Windows 10以降、サードパーティの印刷プロバイダーをサポートする API は非推奨となりました。 Microsoft は、サードパーティの印刷プロバイダーへの投資を推奨していません。 さらに、v4 印刷ドライバー モデルが利用可能なWindows 8以降の製品では、サード パーティの印刷プロバイダーが v4 印刷ドライバーを使用するキューを作成または管理できない場合があります。
UpdatePrintDeviceObject 関数は、印刷プロバイダー キューにあるデバイス オブジェクトのプロパティを更新します。
構文
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
パラメーター
[in] hPrinter
開いているプリンターへのハンドル。 これは、 AddPrinter または OpenPrinter スプーラー関数によって返されたハンドルである必要があります。
[in] hDeviceObject
更新するデバイス オブジェクトへの HANDLE。 これは、 AddPrintDeviceObject で作成されたデバイス オブジェクトである必要があります。
戻り値
UpdatePrintDeviceObject 関数は、デバイス オブジェクトのプロパティが正常に更新された場合、S_OKを返します。 それ以外の場合は、エラーを返します。
たとえば、関数呼び出しが無効な HANDLE で行われた場合、または関数呼び出しが行われる前にデバイス オブジェクトが削除された場合、この関数は HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) を返すことができます。
注釈
PRINTER_INFO_2構造体は、UpdatePrintDeviceObject で更新できるプロパティの種類の良い例です。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | winsplp.h (Winspool.h を含む) |
| Library | WinSpool.lib |
| [DLL] | WinSpool.drv |