AddPrinterConnection 函式

AddPrinterConnection函式會將連接新增至目前使用者的指定印表機。

語法

BOOL AddPrinterConnection(
  _In_ LPTSTR pName
);

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

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

注意

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

當 Windows 連接到印表機時，可能需要將印表機驅動程式檔案複製到印表機所連接的伺服器。如果使用者沒有將檔案複製到適當位置的許可權， AddPrinterConnection 函式會失敗，而且 GetLastError 會傳回ERROR_ACCESS_DENIED。

呼叫 AddPrinterConnection 所建立的印表機連線會在 呼叫 EnumPrinters 且 dwType 設定為 PRINTER_ENUM_CONNECTION 時加以列舉。

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