警告
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 が更新できるプロパティの種類 良い例です。
必要条件
要件 | 価値 |
---|---|
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | winsplp.h (Winspool.h を含む) |
ライブラリ | WinSpool.lib |
DLL | WinSpool.drv |
関連項目
AddPrintDeviceObject の