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)