SetupConfigureWmiFromInfSectionW 函数 (setupapi.h)

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

SetupConfigureWmiFromInfSection 函数配置在传递到 [DDInstall.WMI] 节时由 INF 文件公开的 WMI 数据的安全性。

当系统上的 SetupAPI 版本本身不支持 INF 文件的 DDInstall 节中提供的 WMI 安全信息时，它用于建立安全性。

语法

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionW(
  [in] HINF   InfHandle,
  [in] PCWSTR SectionName,
  [in] DWORD  Flags
);

参数

[in] InfHandle

打开的 INF 文件的句柄。

[in] SectionName

INF 文件中包含 WMI 安全信息的节的名称。 此格式应为[DDinstall.WMI]。

[in] Flags

可以按如下方式设置此参数。

标志	含义
SCWMI_CLOBBER_SECURITY 0x0001	如果并且仅当设置了此标志时，传递给此函数的安全信息才会替代 INF 文件中的其他位置设置的任何安全信息。 如果此标志不存在且 INF 文件中不存在任何安全信息，则设置安全性。

返回值

此函数返回 WINSETUPAPI BOOL。

注解

在以前的 SetupAPI 版本中，INF 文件中的 WMI 信息向所有用户公开，只能通过将二进制数据正确写入注册表项来限制访问。 当前版本读取和处理 INF 文件的 DDInstall 节提供的 WMI 安全信息。

注意

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

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	setupapi.h
Library	Setupapi.lib
DLL	Setupapi.dll

请参阅

函数

概述

从 INF 文件指定安全描述符