共用方式為


ClosePrinter 函式

ClosePrinter函式會關閉指定的印表機物件。

語法

BOOL ClosePrinter(
  _In_ HANDLE hPrinter
);

參數

hPrinter [in]

要關閉之印表機物件的控制碼。 OpenPrinterAddPrinter函式會傳回此控制碼。

傳回值

如果函式成功,則傳回值是非零值。

如果此函式失敗,則傳回值為零。

備註

注意

這是封鎖或同步函式,可能不會立即傳回。 此函式傳回的速度取決於執行時間因素,例如網路狀態、列印伺服器組態,以及難以在撰寫應用程式時預測的印表機驅動程式實作因素。 從管理與使用者介面互動的執行緒呼叫此函式,可能會讓應用程式看起來沒有回應。

當 ClosePrinter函式傳回時,不論函式是否成功或失敗,控制碼hPrinter都無效。

範例

如需使用此函式的範例程式,請參閱 How To: Print Using the GDI Print API

規格需求

需求
最低支援的用戶端
Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Winspool.h (包含 Windows.h)
程式庫
Winspool.lib
DLL
Spoolss.dll

另請參閱

列印

列印多工緩衝處理器 API 函式

AddPrinter

OpenPrinter