AddPrintProcessor 函式

AddPrintProcessor函式會在指定的伺服器上安裝列印處理器，並將列印處理器名稱新增至支援的列印處理器清單。

語法

BOOL AddPrintProcessor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pPathName,
  _In_ LPTSTR pPrintProcessorName
);

pName [in]: Null 終止字串的指標，指定應該安裝列印處理器的伺服器名稱。如果此參數為 Null，則會在本機安裝列印處理器。
pEnvironment [in]: Null 終止字串的指標，指定環境 (例如 Windows x86、Windows IA64 或 Windows x64) 。如果此參數為 Null，則會使用呼叫端/用戶端的目前環境， (不使用目的地/伺服器) 。
pPathName [in]: Null 終止字串的指標，指定包含列印處理器的檔案名。此檔案必須位於系統列印處理器目錄中。
pPrintProcessorName [in]: 指定列印處理器名稱之 Null 終止字串的指標。

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

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

注意

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

呼叫端必須具有 SeLoadDriverPrivilege。

呼叫 AddPrintProcessor 函式之前，應用程式應該先確認包含列印處理器的檔案儲存在系統列印處理器目錄中。應用程式可以藉由呼叫 GetPrintProcessorDirectory 函式 來擷取系統列印處理器目錄的名稱。

應用程式可以呼叫 EnumPrintProcessors 函式來判斷現有列印處理器的名稱。

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