Condividi tramite


Funzione SetupInstallServicesFromInfSectionExA (setupapi.h)

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

[in] SectionName

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

[in] Flags

Controlli per l'installazione.

Contrassegno Significato
SPSVCINST_TAGTOFRONT
0x001
Spostare il tag di 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 installato.
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 di inizio 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 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.
 

[in] DeviceInfoSet

Puntatore facoltativo a un handle a un set di informazioni sul dispositivo. Per altre informazioni, vedere la Guida del programmatore 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 del programmatore 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 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

Vedi anche

Funzioni

Panoramica

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection