SetDefaultPrinter 函式

SetDefaultPrinter 函式會為本機電腦上的目前使用者設定預設印表機的印表機名稱。

語法

BOOL SetDefaultPrinter(
  _In_ LPCTSTR pszPrinter
);

pszPrinter [in]

包含預設印表機名稱之 Null 終止字串的指標。針對遠端印表機連線，名稱格式為 **\\server\**printername。針對本機印表機，名稱格式為 printername。

如果此參數為 Null 或空字串，也就是「」， SetDefaultPrinter 會從其中一部已安裝的印表機中選取預設印表機。如果預設印表機已經存在，請使用Null或此參數中的空字串呼叫SetDefaultPrinter可能會變更預設印表機。

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

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

使用此方法時，您必須指定有效的印表機、驅動程式和埠。如果它們無效，API 不會失敗，但未定義結果。這可能會導致其他程式將印表機設定回先前的有效印表機。您可以使用 EnumPrinters 來擷取所有可用印表機的印表機名稱、驅動程式名稱和埠名稱。

注意

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

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	Winspool.h (包含 Windows.h)
程式庫	Winspool.lib
DLL	Winspool.drv
Unicode 與 ANSI 名稱	SetDefaultPrinterW (Unicode) 和 SetDefaultPrinterA (ANSI)