[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue usándose para instalar controladores de dispositivo.]
La función SetupInstallServicesFromInfSection realiza operaciones de instalación y eliminación del servicio que se especifican en las secciones Instalación del servicio de que se enumeran en la sección servicio de de un archivo INF.
Se requiere un autor de llamada de esta función para tener acceso a Service Control Managery privilegios para modificar los servicios.
Identificador del archivo INF que contiene la sección Service.
[in] SectionName
Nombre de la sección service que se va a procesar. Debe usar una cadena terminada en null.
[in] Flags
Controles para la instalación de cada servicio en la sección especificada.
Bandera
Significado
SPSVCINST_TAGTOFRONT
0x001
Sección AddService: mueva la etiqueta de servicio al principio de su lista de pedidos de grupo.
SPSVCINST_DELETEEVENTLOGENTRY
0x004
Sección DelService: elimine la entrada del registro de eventos.
SPSVCINST_NOCLOBBER_DISPLAYNAME
0x008
Sección AddService: no sobrescriba el nombre para mostrar si ya existe uno.
SPSVCINST_NOCLOBBER_STARTTYPE
0x010
Sección AddService: no sobrescriba el valor de tipo de inicio si el servicio ya existe.
SPSVCINST_NOCLOBBER_ERRORCONTROL
0x020
Sección AddService: no sobrescriba el valor del control de errores si el servicio ya existe.
SPSVCINST_NOCLOBBER_LOADORDERGROUP
0x040
Sección AddService: no sobrescriba el grupo de pedidos de carga si ya existe.
SPSVCINST_NOCLOBBER_DEPENDENCIES
0x080
Sección AddService: no sobrescriba la lista de dependencias si ya existe.
SPSVCINST_NOCLOBBER_DESCRIPTION
0x100
Sección AddService: marque este servicio como controlador de función para el dispositivo que se va a instalar.
SPSVCINST_STOPSERVICE
0x200
Sección DelService: detenga el servicio asociado especificado en la entrada antes de eliminar el servicio.
SPSVCINST_CLOBBER_SECURITY
0x400
Sección AddService: la configuración de seguridad del servicio se sobrescribe si el servicio ya existe en el sistema.
Nota Disponible a partir de Windows Server 2003 y Windows XP.
SPSVCINST_STARTSERVICE
0x800
Sección AddService: inicie el servicio después de instalar el servicio. Esta marca no se puede usar para iniciar un servicio que implemente un controlador de función Plug and Play (PnP) o un controlador de filtro para un dispositivo. De lo contrario, esta marca se puede usar para iniciar un servicio en modo de usuario o en modo kernel administrado por Service Control Manager (SCM).
Nota Disponible a partir de Windows Server 2008 y Windows Vista.
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES
0x1000
Sección AddService: no sobrescriba los privilegios necesarios del servicio especificado si el servicio ya existe en el sistema.
Nota Disponible a partir de Windows Server 2008 R2 y Windows 7.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero. La función llama a SetLastError con ERROR_SUCCESS_REBOOT_REQUIRED si se requiere un reinicio del sistema.
Si se produce un error en la función, el valor devuelto es 0 (cero). Para obtener información de error extendida, llame a GetLastError.
Observaciones
Nota
El encabezado setupapi.h define SetupInstallServicesFromInfSection como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
Requisito
Valor
cliente mínimo admitido
Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido
Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de
Windows
encabezado de
setupapi.h
biblioteca de
Setupapi.lib
DLL de
Setupapi.dll
conjunto de API de
ext-ms-win-setupapi-classinstallers-l1-1-2 (introducido en Windows 10, versión 10.0.14393)