Funzione SetupInstallServicesFromInfSectionExA (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 SetupInstallServicesFromInfSectionEx esegue operazioni di installazione ed eliminazione del servizio specificate nelle sezioni Service Install elencate nella sezione Service 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 SetupInstallServicesFromInfSectionExA(
  [in] HINF             InfHandle,
  [in] PCSTR            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 del servizio .

[in] SectionName

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

[in] Flags

Controlli per l'installazione.

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

Osservazioni

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

SetupInstallServicesFromInfSectionEx 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

Vedere anche

Funzioni

panoramica

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection

Condividi tramite