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