SetupUninstallOEMInfA 函数 (setupapi.h)

[此函数可用于“要求”部分所示的操作系统。 它可能在后续版本中变更或不可用。 安装程序API 不应再用于安装应用程序。 请改用 Windows 安装程序来开发应用程序安装程序。 SetupAPI 继续用于安装设备驱动程序。]

SetupUninstallOEMInf 函数卸载指定的 .inf 文件和任何关联的 .pnf 文件。 如果 .inf 文件与用于签名驱动程序的目录一起安装,则也会删除该目录。 此函数的调用方必须具有管理权限,否则函数将失败。

语法

WINSETUPAPI BOOL SetupUninstallOEMInfA(
  [in] PCSTR InfFileName,
  [in] DWORD Flags,
  [in] PVOID Reserved
);

参数

[in] InfFileName

要卸载的 Windows Inf 目录中 .inf 文件的文件名(不带路径)。

[in] Flags

可以按如下所示设置此参数。

标志 含义
SUOI_FORCEDELETE
0x0001
SetupUninstallOEMInf 函数首先检查是否有使用 .inf 文件安装的任何设备。 无需存在设备,就可以使用 .inf 文件检测到该设备。

如果未设置此标志,并且函数找到使用此 .inf 文件安装的当前安装设备,则不会删除 .inf 文件。

如果设置了此标志,则无论函数是否查找随此 .inf 文件一起安装的设备,都将删除 .inf 文件。

注意 此标志仅适用于 x86、amd64 和 ia64 体系结构。  它在所有其他体系结构上被忽略。
 
注意如果驱动程序包有任何文件复制到使用 DirId 为 13 的 DestinationDir,则忽略此强制标志。
 
注意 建议使用 DiUninstallDriver 删除驱动程序包,而不是使用此标志。
 

[in] Reserved

设置为 null

返回值

此函数返回 WINSETUPAPI BOOL。

注解

注意

setupapi.h 标头将 SetupUninstallOEMInf 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 setupapi.h
Library Setupapi.lib
DLL Setupapi.dll
API 集 Windows 10版本 10.0.1439 (3 中引入的 ext-ms-win-setupapi-classinstallers-l1-1-2)

请参阅

函数

概述

SetupCopyOEMInf

DiUninstallDriver