AddPrintProvidor 函式

重要

在 2021 年 7 月 6 日， KB5005010 引進了選擇性的登錄型組態選項，以限制只能存取此 API 給系統管理員使用者。此選項為預設值。

在 2021 年 8 月 10 日， KB5005652 會變更此設定的預設值，以要求系統管理員許可權才能安裝新的印表機驅動程式。

AddPrintProvidor函式會安裝本機列印提供者，並連結組態、資料和提供者檔案。

語法

BOOL AddPrintProvidor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pProviderInfo
);

pName [in]

Null 終止字串的指標，指定應該安裝提供者的伺服器名稱。對於僅支援本機安裝提供者的系統，此參數應該是 Null。

層級 [in]

pProviderInfo指向的結構層級。它可以是下列其中一項。

值	意義
1	函式會使用 PROVIDOR_INFO_1 結構。
2	函式會使用 PROVIDOR_INFO_2 結構。

pProviderInfo [in]

列印提供者結構的指標，如 Level所指示。

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

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

注意

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

在應用程式呼叫 AddPrintProvidor 函式之前，提供者所需的所有檔案都必須複製到 SYSTEM32 目錄。

AddPrintProvidor新增的提供者可藉由呼叫DeletePrintProvidor來移除。

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