共用方式為


GetDefaultPrinter 函式

GetDefaultPrinter函式會擷取本機電腦上目前使用者的預設印表機名稱。

語法

BOOL GetDefaultPrinter(
  _In_    LPTSTR  pszBuffer,
  _Inout_ LPDWORD pcchBuffer
);

參數

pszBuffer [in]

緩衝區的指標,接收包含預設印表機名稱的 Null 終止字元字串。 如果此參數為 Null,函式會失敗, 而 pcchBuffer 所指向的變數會以字元傳回所需的緩衝區大小。

pcchBuffer [in, out]

在輸入上,指定 pszBuffer 緩衝區的大小,以字元為單位。 在輸出中,接收印表機名稱字串的大小,以字元為單位,包括終止的 Null 字元。

傳回值

如果函式成功,傳回值是非零值, 而 pcchBuffer 所指向的變數包含複製到 pszBuffer 緩衝區的字元數,包括終止 Null 字元。

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

意義
ERROR_INSUFFICIENT_BUFFER pszBuffer緩衝區太小。 pcchBuffer所指向的變數包含所需的緩衝區大小,以字元為單位。
ERROR_FILE_NOT_FOUND 沒有預設印表機。

備註

注意

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

規格需求

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

另請參閱

列印

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

SetDefaultPrinter