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

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

  • Статья

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

Функция SetupInstallServicesFromInfSection выполняет операции установки и удаления службы, указанные в разделах Установка службы , перечисленных в разделе Service в INF-файле.

Вызывающий объект этой функции должен иметь доступ к диспетчеру управления службами и привилегии для изменения служб.

Синтаксис

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

Параметры

[in] InfHandle

Дескриптор INF-файла, содержащего раздел Service .

[in] SectionName

Имя обрабатываемого раздела службы . Следует использовать строку со значением NULL.

[in] Flags

Элементы управления для установки каждой службы в указанном разделе.

Flag Значение
SPSVCINST_TAGTOFRONT
0x001
 Раздел AddService: перемещение тега службы в начало списка заказов группы.
SPSVCINST_DELETEEVENTLOGENTRY
0x004
 Раздел DelService: удаление записи журнала событий.
SPSVCINST_NOCLOBBER_DISPLAYNAME
0x008
 Раздел AddService: не перезаписывайте отображаемое имя, если оно уже существует.
SPSVCINST_NOCLOBBER_STARTTYPE
0x010
 Раздел AddService: не перезаписывайте значение начального типа, если служба уже существует.
SPSVCINST_NOCLOBBER_ERRORCONTROL
0x020
 Раздел AddService: не перезаписывайте значение элемента управления ошибками, если служба уже существует.
SPSVCINST_NOCLOBBER_LOADORDERGROUP
0x040
 Раздел AddService: не перезаписывать группу заказов загрузки, если она уже существует.
SPSVCINST_NOCLOBBER_DEPENDENCIES
0x080
 Раздел AddService: не перезаписывайте список зависимостей, если он уже существует.
SPSVCINST_NOCLOBBER_DESCRIPTION
0x100
 Раздел AddService: пометьте эту службу как драйвер функции для устанавливаемого устройства.
SPSVCINST_STOPSERVICE
0x200
 Раздел DelService. Перед удалением службы остановите связанную службу, указанную в записи.
SPSVCINST_CLOBBER_SECURITY
0x400
 Раздел AddService. Параметры безопасности службы перезаписываются, если служба уже существует в системе.
Примечание Доступно начиная с Windows Server 2003 и Windows XP.
 
SPSVCINST_STARTSERVICE
0x800
 Раздел AddService: запуск службы после установки службы. Этот флаг нельзя использовать для запуска службы, реализующей драйвер функции Plug and Play (PnP) или драйвер фильтра для устройства. В противном случае этот флаг можно использовать для запуска службы в пользовательском режиме или режиме ядра, управляемой диспетчером управления службами (SCM).
Примечание Доступно начиная с Windows Server 2008 и Windows Vista.
 
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES
0x1000
 Раздел AddService: не перезаписывайте необходимые привилегии данной службы, если служба уже существует в системе.
Примечание Доступно начиная с Windows Server 2008 R2 и Windows 7.
 

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

Если функция выполняется успешно, возвращается ненулевое значение. Функция вызывает SetLastError с ERROR_SUCCESS_REBOOT_REQUIRED, если требуется перезагрузка системы.

Если функция завершается сбоем, возвращаемое значение равно 0 (ноль). Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header setupapi.h
Библиотека Setupapi.lib
DLL Setupapi.dll
Набор API ext-ms-win-setupapi-classinstallers-l1-1-2 (появилось в Windows 10 версии 10.0.14393)

См. также

Функции

Обзор

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx