InstallPrinterDriverFromPackage 函式
從列印伺服器驅動程式存放區中的驅動程式套件安裝印表機驅動程式。
語法
HRESULT InstallPrinterDriverFromPackage(
_In_ LPCTSTR pszServer,
_In_ LPCTSTR pszInfPath,
_In_ LPCTSTR pszDriverName,
_In_ LPCTSTR pszEnvironment,
_In_ DWORD dwFlags
);
參數
-
pszServer [in]
-
指定列印伺服器名稱之常數、以 Null 結束的字串指標。 Null 表示本機電腦。
-
pszInfPath [in]
-
常數、以 Null 終止的字串指標，指定列印驅動程式 .inf 檔案的驅動程式存放區路徑。 Null 表示驅動程式位於隨附于 Windows 的 inf 檔案中。
-
pszDriverName [in]
-
指定驅動程式名稱的常數 Null 終止字串指標。
-
pszEnvironment [in]
-
指定處理器架構 (的常數 null 終止字串指標，例如Windows NT x86) 。 這可以是 Null。
-
dwFlags [in]
-
這只能是 0 或 IPDFP_COPY_ALL_FILES。 值為 0 表示必須新增印表機驅動程式，而且印表機驅動程式目錄中比目前使用中對應檔案更新的任何檔案都必須複製。 IPDFP_COPY_ALL_FILES值表示印表機驅動程式和印表機驅動程式目錄中的所有檔案都必須新增。 當 dwFlags的值為 IPDFP_COPY_ALL_FILES 時，會忽略檔案時間戳記。
傳回值
如果作業成功，傳回值會S_OK，否則 HRESULT 會包含錯誤碼。
如需 COM 錯誤碼的詳細資訊，請參閱 錯誤處理。
備註
注意
這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器設定，以及撰寫應用程式時難以預測的印表機驅動程式實作因素。 從管理與使用者介面互動的執行緒呼叫此函式，可能會使應用程式看起來沒有回應。
驅動程式存放區通常是 %windir%\inf 或 %windir%\System32\DriverStore\FileRepository。
InstallPrinterDriverFromPackage 也會在套件中安裝其他檔案，例如色彩設定檔和列印處理器。
當使用者使用終端機服務登入時，使用者必須具有印表機管理許可權，才能安裝在遠端電腦或本機電腦上。
只有已簽署的套件可以安裝在遠端電腦上。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|
| Unicode 與 ANSI 名稱 |
InstallPrinterDriverFromPackageW (Unicode) 和 InstallPrinterDriverFromPackageA (ANSI) |