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

こちらもご覧ください

AddPrintDeviceObject