Función SetupInstallServicesFromInfSectionExW (setupapi.h)

Artículo
11/20/2024

[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 SetupInstallServicesFromInfSectionEx realiza operaciones de instalación y eliminación del servicio que se especifican en las secciones Service Install que se enumeran en la sección Service 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.

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

[in] SectionName

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

[in] Flags

Los controles de la instalación.

Bandera	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 va a instalar.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Elimine la entrada del registro de eventos de 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 error 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 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.

[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 del conjunto que DeviceInfoSet especifica. 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 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 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 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

Consulte también

funciones de

información general

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

setupInstallServicesFromInfSection

Compartir a través de