Funzione SetupInstallServicesFromInfSectionExW (setupapi.h)

Articolo
08/26/2023

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupInstallServicesFromInfSectionEx esegue operazioni di installazione ed eliminazione del servizio specificate nelle sezioni Installazione del servizio elencate nella sezione Servizio di un file INF.

Un chiamante di questa funzione deve avere accesso a Service Control Manager e privilegi per modificare i servizi.

Sintassi

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

Parametri

[in] InfHandle

Handle per il file INF che contiene la sezione Servizio .

[in] SectionName

Nome della sezione Service da elaborare. È consigliabile usare una stringa con terminazione Null.

[in] Flags

Controlli per l'installazione.

Contrassegno	Significato
SPSVCINST_TAGTOFRONT 0x001	Spostare il tag del servizio nella parte anteriore dell'elenco degli ordini di gruppo.
SPSVCINST_ASSOCSERVICE 0x002	Sezione AddService: contrassegnare questo servizio come driver di funzione per il dispositivo in fase di installazione.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Eliminare la voce del registro eventi per un servizio specificato.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	Non sovrascrivere il nome visualizzato se ne esiste già uno.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	Non sovrascrivere il valore del tipo iniziale se il servizio esiste già.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	Non sovrascrivere il valore del controllo degli errori se il servizio esiste già.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	Non sovrascrivere il gruppo di ordini di carico, se esiste già.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	Non sovrascrivere l'elenco delle dipendenze, se esiste già.
SPSVCINST_NOCLOBBER_DESCRIPTION 0x100	Sezione AddService: contrassegnare questo servizio come driver di funzione per il dispositivo in fase di installazione.
SPSVCINST_STOPSERVICE 0x200	Sezione DelService: arrestare il servizio associato specificato nella voce prima di eliminare il servizio.
SPSVCINST_CLOBBER_SECURITY 0x400	Sezione AddService: le impostazioni di sicurezza del servizio vengono sovrascritte se il servizio esiste già nel sistema. Nota Disponibile a partire da Windows Server 2003 e Windows XP.
SPSVCINST_STARTSERVICE 0x800	Sezione AddService: avviare il servizio dopo l'installazione del servizio. Questo flag non può essere usato per avviare un servizio che implementa un driver di funzione Plug and Play (PnP) o un driver di filtro per un dispositivo. In caso contrario, questo flag può essere usato per avviare un servizio in modalità utente o in modalità kernel gestito da Service Control Manager (SCM). Nota Disponibile a partire da Windows Server 2008 e Windows Vista.
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES 0x1000	Sezione AddService: non sovrascrivere i privilegi necessari del servizio specificato se il servizio esiste già nel sistema. Nota Disponibile a partire da Windows Server 2008 R2 e Windows 7.

[in] DeviceInfoSet

Puntatore facoltativo a un handle a un set di informazioni sul dispositivo. Per altre informazioni, vedere la Guida per programmatori DDK. Questa risorsa potrebbe non essere disponibile in alcune lingue

e paesi.)

[in] DeviceInfoData

Puntatore facoltativo alla struttura SP_DEVINFO_DATA che fornisce un contesto a un elemento specifico nel set specificato da DeviceInfoSet . Per altre informazioni, vedere la Guida per programmatori DDK. Questa risorsa potrebbe non essere disponibile in alcune lingue

e paesi.)

Reserved1

Riservato.

Reserved2

Riservato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero. La funzione chiama SetLastError con ERROR_SUCCESS_REBOOT_REQUIRED se è necessario un riavvio del sistema.

Se la funzione ha esito negativo, il valore restituito è 0 (zero). Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione setupapi.h definisce SetupInstallServicesFromInfSectionEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	setupapi.h
Libreria	Setupapi.lib
DLL	Setupapi.dll