描述
DeletePrinterDriverEx功能从服务器支持的驱动程序的名称列表中删除指定的打印机驱动程序名称，并删除与驱动程序关联的文件。此函数也可以删除驱动程序的特定版本。
C++ 语法
BOOL DeletePrinterDriverEx( __in LPTSTR pName, __in LPTSTR pEnvironment, __in LPTSTR pDriverName, __in DWORD dwDeleteFlag, __in DWORD dwVersionFlag ); |
PowerBASIC 语法
FUNCTION DeletePrinterDriverExA ( _ BYREF pName AS ASCIIZ, _ BYREF pEnvironment AS ASCIIZ, _ BYREF pDriverName AS ASCIIZ, _ BYVAL dwDeleteFlag AS DWORD, _ BYVAL dwVersionFlag AS DWORD _ ) AS LONG |
Unicode版本:
FUNCTION DeletePrinterDriverExW ( _ BYREF pName AS WSTRINGZ, _ BYREF pEnvironment AS WSTRINGZ, _ BYREF pDriverName AS WSTRINGZ, _ BYVAL dwDeleteFlag AS DWORD, _ BYVAL dwVersionFlag AS DWORD _ ) AS LONG |
参数
pName
[in]指向指定要从中删除驱动程序的服务器的名称的以空字符结尾的字符串的指针。如果此参数为NULL，该函数将从本地计算机中删除打印机驱动程序。
pEnvironment
[in]指向指定要从中删除驱动程序的环境的空终止字符串的指针（例如，Windows NT x86，Windows IA64，Windows x64，Windows NT R4000，Windows NT Alpha_AXP，Windows 4.0或Windows NT PowerPC的）。如果此参数为NULL，则从呼叫应用程序和客户端计算机（不是目标应用程序和打印服务器）的当前环境中删除驱动程序名称。
注意 Windows IA64在Windows XP，Windows XP 64位版，Windows Server 2003和更高版本中可用。Windows XP Service Pack 2（SP2），Windows XP Professional x64 Edition，Windows Server 2003 Service Pack 1（SP1）和更高版本中提供Windows x64。
pDriverName
[in]指向要终止的字符串的指针，指定要删除的驱动程序的名称。
dwDeleteFlag
[in]指定用于删除驱动程序的文件和版本的选项。此参数可以是以下值中的一个或多个。
值 |
含义 |
DPD_DELETE_SPECIFIC_VERSION |
删除dwVersionFlag中指定的版本。这不能确保驱动程序将从服务器支持的驱动程序列表中删除。 |
DPD_DELETE_UNUSED_FILES |
删除任何未使用的驱动程序文件。 |
DPD_DELETE_ALL_FILES |
只有当驱动程序的所有相关文件都可以删除时才会删除驱动程序。如果某些其他已安装的驱动程序正在使用任何驱动程序的文件，则删除操作将失败。 |
如果未指定DPD_DELETE_SPECIFIC_VERSION，则如果没有使用驱动程序，该函数将删除所有版本的驱动程序。如果未指定DPD_DELETE_UNUSED_FILES或DPD_DELETE_ALL_FILES，则该函数不会删除驱动程序文件。
dwVersionFlag
[in]指定要删除的驱动程序的版本。该参数可以是0,1,2或3。仅当dwDeleteFlag包含DPD_DELETE_SPECIFIC_VERSION标志时，才使用此参数。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。
备注
在功能删除驱动程序文件之前，它调用驱动程序的DrvDriverEvent功能，允许驱动程序删除任何未使用的私有文件。有关DrvDriverEvent的详细信息，请参阅Microsoft Windows 2000驱动程序开发工具包。
如果当前加载驱动程序文件，该函数将它们移动到临时目录，并在重新启动时将其标记为删除。
在致电DeletePrinterDriverEx之前，您必须删除使用打印机驱动程序的所有打印机对象。
引用文件 #INCLUDE Once
WinSpool.inc（包括Windows.inc）