ClosePrinter 函式

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

語法

BOOL ClosePrinter(
  _In_ HANDLE hPrinter
);

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

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

注意

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

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

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