DeletePrinterDriver 函式

DeletePrinterDriver函式會從伺服器上支援的驅動程式名稱清單中移除指定的印表機驅動程式名稱。

若要刪除與驅動程式相關聯的檔案，除了從伺服器支援的驅動程式名稱清單中移除指定的印表機驅動程式名稱之外，請使用 DeletePrinterDriverEx 函式。

DeletePrinterDriver 只有在未針對指定的環境使用驅動程式版本時，才會刪除驅動程式。 DeletePrinterDriverEx 可以刪除特定版本的驅動程式。

語法

BOOL DeletePrinterDriver(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pDriverName
);

pName [in]: Null 終止字串的指標，指定要從中刪除驅動程式的伺服器名稱。如果此參數為 Null，則會在本機移除印表機驅動程式名稱。
pEnvironment [in]: Null 終止字串的指標，指定要從中 (刪除驅動程式的環境，例如 Windows x86、Windows IA64 或 Windows x64) 。如果此參數為 Null，則會從呼叫應用程式和用戶端電腦的目前環境刪除驅動程式名稱， (不是目的地應用程式和列印伺服器) 。
pDriverName [in]: 指定應該刪除之驅動程式名稱的 Null 終止字串指標。

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

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

注意

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

呼叫端必須具有 SeLoadDriverPrivilege。

DeletePrinterDriver函式不會刪除相關聯的檔案，它只會從EnumPrinterDrivers函式所傳回的清單中移除驅動程式名稱。

呼叫 DeletePrinterDriver之前，您必須刪除所有使用印表機驅動程式的印表機物件。

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