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

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

  • Статья

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

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

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

Синтаксис

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента 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