<Return[D]><Top>

DeletePrinter

Declare Function Api_DeletePrinter& Lib "winspool.drv" Alias "DeletePrinter" (ByVal hPrinter&)

Declare Function DeletePrinter Lib "winspool.drv" Alias "DeletePrinter" (ByVal hPrinter As Long) As Long

指定されたプリンタオブジェクトを削除する。

パラメータ
hPrinter
    削除対象のプリンタオブジェクトのハンドルを指定する。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    プリンタハンドル hPrinter は、OpenPrinter 関数または AddPrinter 関数を使って取得する。たいていは OpenPrinter 関数を使う。
    指定したプリンタに処理対象の印刷ジョブが残っていると、DeletePrinter 関数はそのプリンタを削除待ちにし、すべての印刷ジョブの処理

    が終わった時点で削除する。削除待ちになっているプリンタに印刷ジョブを追加することはできない。
    また、削除待ちになっているプリンタを一時停止することもできないが、印刷ジョブの一時停止、一時停止した印刷ジョブの再開、印刷ジョ

    ブの再実行は可能である。指定したプリンタが一時停止中で、そのプリンタに印刷ジョブがあると、DeletePrinter 関数は InvalidState エ

    ラーで失敗する。