Funzione SetupInstallServicesFromInfSectionA (setupapi.h)

Articolo
01/06/2025

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata 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 SetupInstallServicesFromInfSection esegue operazioni di installazione ed eliminazione del servizio specificate nelle sezioni installazione del servizio elencate nella sezione servizio di un file INF.

È necessario un chiamante di questa funzione per avere accesso all'Service Control Managere i privilegi per modificare i servizi.

Sintassi

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Parametri

[in] InfHandle

Handle per il file INF che contiene la sezione del servizio .

[in] SectionName

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

[in] Flags

Controlli per l'installazione di ogni servizio nella sezione specificata.

Bandiera	Significato
SPSVCINST_TAGTOFRONT 0x001	Sezione AddService: spostare il tag del servizio all'inizio dell'elenco degli ordini di gruppo.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Sezione DelService: eliminare la voce del registro eventi.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	Sezione AddService: non sovrascrivere il nome visualizzato se ne esiste già uno.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	Sezione AddService: non sovrascrivere il valore del tipo di inizio se il servizio esiste già.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	Sezione AddService: non sovrascrivere il valore del controllo degli errori se il servizio esiste già.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	Sezione AddService: non sovrascrivere il gruppo di ordini di carico se esiste già.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	Sezione AddService: 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.

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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Nota

L'intestazione setupapi.h definisce SetupInstallServicesFromInfSection 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

SetupInstallServicesFromInfSection registra le informazioni di diagnostica nel log di testo dell'installazione dell'applicazione setupAPI. Questo file di log è in genere disattivato per impostazione predefinita. Può essere abilitata modificando i livelli di registrazione Generale parte del valore LogLevel SetupAPI, come descritto in Impostazione dei livelli di registrazione SETUPAPI. Per motivi di prestazioni, è consigliabile abilitare questo file di log solo quando si risolve un problema. Quando il file di log è abilitato, è possibile trovarlo in %windir%\inf\setupapi.app.log.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	setupapi.h
libreria	Setupapi.lib
dll	Setupapi.dll
set di API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotto in Windows 10, versione 10.0.14393)

Vedere anche

Funzioni

panoramica

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx

Condividi tramite