Funzione ChangeServiceConfigA (winsvc.h)
Modifica i parametri di configurazione di un servizio.
Per modificare i parametri di configurazione facoltativi, usare la funzione ChangeServiceConfig2 .
Sintassi
BOOL ChangeServiceConfigA(
[in] SC_HANDLE hService,
[in] DWORD dwServiceType,
[in] DWORD dwStartType,
[in] DWORD dwErrorControl,
[in, optional] LPCSTR lpBinaryPathName,
[in, optional] LPCSTR lpLoadOrderGroup,
[out, optional] LPDWORD lpdwTagId,
[in, optional] LPCSTR lpDependencies,
[in, optional] LPCSTR lpServiceStartName,
[in, optional] LPCSTR lpPassword,
[in, optional] LPCSTR lpDisplayName
);
Parametri
[in] hService
Handle per il servizio. Questo handle viene restituito dalla funzione OpenService o CreateService e deve avere il diritto di accesso SERVICE_CHANGE_CONFIG . Per altre informazioni, vedere Sicurezza del servizio e diritti di accesso.
[in] dwServiceType
Tipo di servizio. Specificare SERVICE_NO_CHANGE se non si modifica il tipo di servizio esistente; in caso contrario, specificare uno dei tipi di servizio seguenti.
Se si specifica SERVICE_WIN32_OWN_PROCESS o SERVICE_WIN32_SHARE_PROCESS e il servizio è in esecuzione nel contesto dell'account LocalSystem, è anche possibile specificare il tipo seguente.
| Valore | Significato |
|---|---|
|
Il servizio può interagire con il desktop.
Per altre informazioni, vedere Interactive Services. |
[in] dwStartType
Opzioni di avvio del servizio. Specificare SERVICE_NO_CHANGE se non si modifica il tipo di avvio esistente; in caso contrario, specificare uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Un servizio avviato automaticamente dal gestore di controllo del servizio durante l'avvio del sistema. |
|
Driver di dispositivo avviato dal caricatore di sistema. Questo valore è valido solo per i servizi del driver. |
|
Servizio avviato da Gestione controllo del servizio quando un processo chiama la funzione StartService . |
|
Servizio che non può essere avviato. I tentativi di avvio del servizio generano il codice di errore ERROR_SERVICE_DISABLED. |
|
Driver di dispositivo avviato dalla funzione IoInitSystem . Questo valore è valido solo per i servizi del driver. |
[in] dwErrorControl
Gravità dell'errore e azione eseguita, se il servizio non viene avviato. Specificare SERVICE_NO_CHANGE se non si modifica il controllo degli errori esistente; in caso contrario, specificare uno dei valori seguenti.
[in, optional] lpBinaryPathName
Percorso completo del file binario del servizio. Specificare NULL se non si modifica il percorso esistente. Se il percorso contiene uno spazio, deve essere racchiuso tra virgolette in modo che venga interpretato correttamente. Ad esempio, "d:\my share\myservice.exe" deve essere specificato come ""d:\my share\myservice.exe"".
Il percorso può includere anche argomenti per un servizio di avvio automatico. Ad esempio, "d:\myshare\myservice.exe arg1 arg2". Questi argomenti vengono passati al punto di ingresso del servizio (in genere la funzione principale ).
Se si specifica un percorso in un altro computer, la condivisione deve essere accessibile dall'account computer del computer locale perché si tratta del contesto di sicurezza utilizzato nella chiamata remota. Tuttavia, questo requisito consente a eventuali potenziali vulnerabilità nel computer remoto di influire sul computer locale. Pertanto, è consigliabile usare un file locale.
[in, optional] lpLoadOrderGroup
Nome del gruppo di ordinamento del carico di cui il servizio è membro. Specificare NULL se non si modifica il gruppo esistente. Specificare una stringa vuota se il servizio non appartiene a un gruppo.
Il programma di avvio usa i gruppi di ordinamento del carico per caricare gruppi di servizi in un ordine specificato rispetto agli altri gruppi. L'elenco dei gruppi di ordinamento del carico è contenuto nel valore ServiceGroupOrder della chiave del Registro di sistema seguente:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control
[out, optional] lpdwTagId
Puntatore a una variabile che riceve un valore di tag univoco nel gruppo specificato nel parametro lpLoadOrderGroup . Specificare NULL se non si modifica il tag esistente.
È possibile usare un tag per l'avvio del servizio di ordinamento all'interno di un gruppo di ordinamento di carico specificando un vettore di ordine tag nel valore GroupOrderList della chiave del Registro di sistema seguente:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control
I tag vengono valutati solo per i servizi driver con SERVICE_BOOT_START o SERVICE_SYSTEM_START tipi di avvio.
[in, optional] lpDependencies
Puntatore a una matrice con terminazione Null doppia di nomi separati da Null di servizi o gruppi di ordinamento di carico che il sistema deve avviare prima di poter avviare il servizio. La dipendenza da un gruppo significa che questo servizio può essere eseguito se almeno un membro del gruppo è in esecuzione dopo un tentativo di avviare tutti i membri del gruppo. Specificare NULL se non si modificano le dipendenze esistenti. Specificare una stringa vuota se il servizio non ha dipendenze.
È necessario prefissi i nomi di gruppo con SC_GROUP_IDENTIFIER in modo che possano essere distinti da un nome del servizio, perché i servizi e i gruppi di servizi condividono lo stesso spazio dei nomi.
[in, optional] lpServiceStartName
Nome dell'account in cui deve essere eseguito il servizio. Specificare NULL se non si modifica il nome dell'account esistente. Se il tipo di servizio è SERVICE_WIN32_OWN_PROCESS, usare un nome account nel formato DomainName UserName\. Il processo di servizio verrà eseguito l'accesso come utente. Se l'account appartiene al dominio predefinito, è possibile specificare .\UserName (si noti che la stringa C/C++ corrispondente è ".\\UserName"). Per altre informazioni, vedere Account utente del servizio e l'avviso nella sezione Osservazioni.
Un processo condiviso può essere eseguito come qualsiasi utente.
Se il tipo di servizio è SERVICE_KERNEL_DRIVER o SERVICE_FILE_SYSTEM_DRIVER, il nome è il nome dell'oggetto driver usato dal sistema per caricare il driver di dispositivo. Specificare NULL se il driver deve usare un nome oggetto predefinito creato dal sistema di I/O.
Un servizio può essere configurato per usare un account gestito o un account virtuale. Se il servizio è configurato per l'uso di un account del servizio gestito, il nome è il nome dell'account del servizio gestito. Se il servizio è configurato per l'uso di un account virtuale, specificare il nome come NT SERVICE\ServiceName. Per altre informazioni sugli account del servizio gestito e sugli account virtuali, vedere La Guida dettagliata agli account di servizio.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Gli account del servizio gestito e gli account virtuali non sono supportati fino a Windows 7 e Windows Server 2008 R2.
[in, optional] lpPassword
Password del nome dell'account specificato dal parametro lpServiceStartName . Specificare NULL se non si modifica la password esistente. Specificare una stringa vuota se l'account non ha password o se il servizio viene eseguito nell'account LocalService, NetworkService o LocalSystem. Per altre informazioni, vedere Elenco record del servizio.
Se il nome dell'account specificato dal parametro lpServiceStartName è il nome di un account del servizio gestito o un nome account virtuale, il parametro lpPassword deve essere NULL.
Le password vengono ignorate per i servizi driver.
[in, optional] lpDisplayName
Nome visualizzato da utilizzare dalle applicazioni per identificare il servizio per gli utenti. Specificare NULL se non si modifica il nome visualizzato esistente; in caso contrario, questa stringa ha una lunghezza massima di 256 caratteri. Il nome viene mantenuto in caso di maiuscole e minuscole nella gestione controllo del servizio. I confronti dei nomi visualizzati sono sempre senza distinzione tra maiuscole e minuscole.
Questo parametro può specificare una stringa localizzata usando il formato seguente:
@[path]dllname,-strID
La stringa con identificatore strID viene caricata da dllname; il percorso è facoltativo. Per altre informazioni, vedere RegLoadMUIString.
Windows Server 2003 e Windows XP: Le stringhe localizzate non sono supportate fino a Windows Vista.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
I codici di errore seguenti possono essere impostati dal gestore di controllo del servizio. Altri codici di errore possono essere impostati dalle funzioni del Registro di sistema chiamate dalla gestione controllo del servizio.
| Codice restituito | Descrizione |
|---|---|
|
L'handle non dispone del diritto di accesso SERVICE_CHANGE_CONFIG . |
|
È stata specificata una dipendenza del servizio circolare. |
|
Il nome visualizzato esiste già nel database di gestione controller di servizio, come nome del servizio o come altro nome visualizzato. |
|
L'handle specificato non è valido. |
|
Parametro specificato non valido. |
|
Il nome dell'account non esiste o un servizio viene specificato per condividere lo stesso file binario di un servizio già installato, ma con un nome account non uguale al servizio installato. |
|
Il servizio è stato contrassegnato per l'eliminazione. |
Commenti
La funzione ChangeServiceConfig modifica le informazioni di configurazione per il servizio specificato nel database di gestione controllo del servizio. È possibile ottenere le informazioni di configurazione correnti usando la funzione QueryServiceConfig .
Se la configurazione viene modificata per un servizio in esecuzione, ad eccezione di lpDisplayName, le modifiche non vengono applicate finché il servizio non viene arrestato. Per aggiornare le credenziali senza dover riavviare il servizio, usare la funzione LsaCallAuthenticationPackage .
Osservazioni sulla sicurezza
L'impostazione del parametro lpServiceStartName modifica l'account di accesso del servizio. Ciò può causare problemi. Se è stato registrato un nome dell'entità servizio (SPN), verrà ora registrato nell'account errato. Analogamente, se è stato usato un ACE per concedere l'accesso a un servizio, ora concederebbe l'accesso all'account errato.Esempio
Per un esempio, vedere Modifica della configurazione di un servizio.
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 | winsvc.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |
Vedi anche
QueryServiceDynamicInformation