Funzione SetupInstallServicesFromInfSectionA (setupapi.h)

  • Articolo

[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)

Vedi anche

Funzioni

Panoramica

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx