Función SetupInstallServicesFromInfSectionExW (setupapi.h)

  • Artículo

[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 SetupInstallServicesFromInfSectionExW(
  [in] HINF             InfHandle,
  [in] PCWSTR           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

Vea también

Funciones

Información general

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection