Función SetupInstallServicesFromInfSectionExA (setupapi.h)

Artículo
03/05/2024

[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue utilizándose para instalar controladores de dispositivo.

La función SetupInstallServicesFromInfSectionEx realiza las operaciones de instalación y eliminación del servicio que se especifican en las secciones Instalación del servicio enumeradas en la sección Servicio de un archivo INF.

Se requiere un autor de llamada de esta función para tener acceso al Administrador de control de servicios y privilegios para modificar los servicios.

Sintaxis

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionExA(
  [in] HINF             InfHandle,
  [in] PCSTR            SectionName,
  [in] DWORD            Flags,
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
       PVOID            Reserved1,
       PVOID            Reserved2
);

Parámetros

[in] InfHandle

Identificador del archivo INF que contiene la sección Servicio .

[in] SectionName

Nombre de la sección Servicio que se va a procesar. Debe usar una cadena terminada en null.

[in] Flags

Controles de la instalación.

Marca	Significado
SPSVCINST_TAGTOFRONT 0x001	Mueva la etiqueta de servicio al principio de su lista de pedidos de grupo.
SPSVCINST_ASSOCSERVICE 0x002	Sección AddService: marque este servicio como controlador de función para el dispositivo que se está instalando.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Elimine la entrada del registro de eventos para un servicio especificado.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	No sobrescriba el nombre para mostrar si ya existe uno.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	No sobrescriba el valor de tipo de inicio si el servicio ya existe.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	No sobrescriba el valor del control de errores si el servicio ya existe.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	No sobrescriba el grupo de pedidos de carga si ya existe.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	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 está instalando.
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 que el 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 una vez instalado el servicio. Esta marca no se puede usar para iniciar un servicio que implemente un controlador de función de 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 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.

[in] DeviceInfoSet

Puntero opcional a un identificador de un conjunto de información del dispositivo. Para obtener más información, consulte la Guía del programador de DDK. (Es posible que este recurso no esté disponible en algunos idiomas

y países).

[in] DeviceInfoData

Puntero opcional a la estructura SP_DEVINFO_DATA que proporciona un contexto a un elemento específico en el conjunto especificado por DeviceInfoSet . Para obtener más información, consulte la Guía del programador de DDK. (Es posible que este recurso no esté disponible en algunos idiomas

y países).

Reserved1

Reservado.

Reserved2

Reservado.

Valor devuelto

Si la función se realiza 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 la función no se realiza correctamente, el valor devuelto es 0 (cero). Para obtener información de error extendida, llame a GetLastError.

Comentarios

Nota

El encabezado setupapi.h define SetupInstallServicesFromInfSectionEx 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	setupapi.h
Library	Setupapi.lib
Archivo DLL	Setupapi.dll