Поделиться через


Функция SetupConfigureWmiFromInfSectionA (setupapi.h)

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

Функция SetupConfigureWmiFromInfSection настраивает безопасность данных WMI, которые предоставляются INF-файлом при передаче в раздел [DDInstall.WMI].

Он используется для обеспечения безопасности, если версия SetupAPI в системе не поддерживает сведения о безопасности WMI, предоставленные в разделе DDInstall INF-файла.

Синтаксис

WINSETUPAPI BOOL SetupConfigureWmiFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Параметры

[in] InfHandle

Дескриптор открытого INF-файла.

[in] SectionName

Имя раздела в INF-файле, содержащего сведения о безопасности WMI. Это должно быть в формате [DDinstall.WMI].

[in] Flags

Этот параметр можно задать следующим образом.

Flag Значение
SCWMI_CLOBBER_SECURITY
0x0001
Если и только если этот флаг установлен, сведения о безопасности, передаваемые в эту функцию, переопределяют любой набор сведений о безопасности в других местах INF-файла. Если этот флаг не существует, а в INF-файле нет сведений о безопасности, устанавливается безопасность.

Возвращаемое значение

Эта функция возвращает ЛОГИЧЕСКОЕ ЗНАЧЕНИЕ WINSETUPAPI.

Комментарии

В предыдущих версиях SetupAPI сведения О WMI в INF-файлах предоставляются всем пользователям, и доступ можно было ограничить только путем правильной записи двоичных данных в раздел реестра. Текущие версии считывают и обрабатывают сведения о безопасности WMI, предоставляемые разделом DDInstall INF-файла.

Примечание

Заголовок setupapi.h определяет SetupConfigureWmiFromInfSection в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header setupapi.h
Библиотека Setupapi.lib
DLL Setupapi.dll

См. также

Функции

Обзор

Указание дескриптора безопасности из INF-файла