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


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

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

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

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

Синтаксис

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-файле отсутствуют, устанавливается безопасность.

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

Эта функция возвращает BOOL WINSETUPAPI.

Замечания

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

Заметка

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Не поддерживается
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
заголовка setupapi.h
библиотеки Setupapi.lib
DLL Setupapi.dll

См. также

Функции

Обзор

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