Compartir a través de

Función SetupInstallServicesFromInfSectionW (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 SetupInstallServicesFromInfSection realiza 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 SetupInstallServicesFromInfSectionW(
  [in] HINF   InfHandle,
  [in] PCWSTR SectionName,
  [in] DWORD  Flags
);

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 para la instalación de cada servicio en la sección especificada.

Marca 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 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.
 

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 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 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
Conjunto de API ext-ms-win-setupapi-classinstallers-l1-1-2 (introducido en Windows 10, versión 10.0.14393)

Vea también

Funciones

Información general

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx