Funzione SetupInstallServicesFromInfSectionExA (setupapi.h)

Articolo
03/13/2024

[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