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 を呼び出す必要はありません。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	winsplp.h (Winspool.h を含む)
ライブラリ	WinSpool.lib
DLL	WinSpool.drv

関連項目

AddPrintDeviceObject の