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 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|
| Unicode 與 ANSI 名稱 |
SetDefaultPrinterW (Unicode) 和 SetDefaultPrinterA (ANSI) |