Funzione SetupInstallServicesFromInfSectionA (setupapi.h)

Articolo
03/15/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 di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

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

Per modificare i servizi è necessario un chiamante di questa funzione per avere accesso a Service Control Manager e privilegi.

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

[in] SectionName

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

[in] Flags

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

Contrassegno	Significato
SPSVCINST_TAGTOFRONT 0x001	Sezione AddService: spostare il tag del servizio nella parte anteriore 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à una.
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 installato.
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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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
Set di API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotta in Windows 10, versione 10.0.14393)