struttura QUERY_SERVICE_CONFIGA (winsvc.h)
Contiene informazioni di configurazione per un servizio installato. Viene usato dalla funzione QueryServiceConfig .
Sintassi
typedef struct _QUERY_SERVICE_CONFIGA {
DWORD dwServiceType;
DWORD dwStartType;
DWORD dwErrorControl;
LPSTR lpBinaryPathName;
LPSTR lpLoadOrderGroup;
DWORD dwTagId;
LPSTR lpDependencies;
LPSTR lpServiceStartName;
LPSTR lpDisplayName;
} QUERY_SERVICE_CONFIGA, *LPQUERY_SERVICE_CONFIGA;
Members
dwServiceType
Tipo di servizio. Questo membro può essere uno dei valori seguenti.
Se il valore è SERVICE_WIN32_OWN_PROCESS o SERVICE_WIN32_SHARE_PROCESS e il servizio è in esecuzione nel contesto dell'account LocalSystem, è possibile specificare anche il tipo seguente.
| Valore | Significato |
|---|---|
|
Il servizio può interagire con il desktop.
Per altre informazioni, vedere Interactive Services. |
dwStartType
Quando avviare il servizio. Questo membro può essere 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. |
dwErrorControl
Gravità dell'errore e azione eseguita, se il servizio non viene avviato. Questo membro può essere uno dei valori seguenti.
lpBinaryPathName
Percorso completo del file binario del servizio.
Il percorso può includere anche argomenti per un servizio di avvio automatico. Questi argomenti vengono passati al punto di ingresso del servizio (in genere la funzione principale ).
lpLoadOrderGroup
Nome del gruppo di ordinamento di carico a cui appartiene il servizio. Se il membro è NULL o una stringa vuota, il servizio non appartiene a un gruppo di ordinamento di carico.
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 seguente valore del Registro di sistema:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder
dwTagId
Valore di tag univoco per questo servizio nel gruppo specificato dal parametro lpLoadOrderGroup . Il valore zero indica che al servizio non è stato assegnato un tag. È possibile usare un tag per l'avvio del servizio di ordinamento all'interno di un gruppo di ordini di carico specificando un vettore di ordine di tag nel Registro di sistema in:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList
I tag vengono valutati solo per i servizi di tipo SERVICE_KERNEL_DRIVER e SERVICE_FILE_SYSTEM_DRIVER con tipi di avvio SERVICE_BOOT_START o SERVICE_SYSTEM_START .
lpDependencies
Puntatore a una matrice di nomi separati da Null di servizi o gruppi di ordinamento di carico che devono iniziare prima di questo servizio. La matrice è con terminazione null doppia. Se il puntatore è NULL o se punta a una stringa vuota, il servizio non ha dipendenze. Se viene specificato un nome di gruppo, deve essere preceduto dal carattere SC_GROUP_IDENTIFIER (definito in WinSvc.h) per distinguerlo da un nome di servizio, perché i servizi e i gruppi di servizi condividono lo stesso spazio dei nomi. La dipendenza da un servizio significa che questo servizio può essere eseguito solo se il servizio da cui dipende è in esecuzione. 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.
lpServiceStartName
Se il tipo di servizio è SERVICE_WIN32_OWN_PROCESS o SERVICE_WIN32_SHARE_PROCESS, questo membro è il nome dell'account su cui verrà eseguito il processo del servizio. Questo nome può essere del formato Domain\UserName. Se l'account appartiene al dominio predefinito, il nome può essere nel formato .\UserName. Il nome può anche essere "LocalSystem" se il processo è in esecuzione con l'account LocalSystem.
Se il tipo di servizio è SERVICE_KERNEL_DRIVER o SERVICE_FILE_SYSTEM_DRIVER, questo membro è il nome dell'oggetto driver (ovvero \FileSystem\Rdr o \Driver\Xns) usato dal sistema di input e output (I/O) per caricare il driver di dispositivo. Se questo membro è NULL, il driver deve essere eseguito con un nome di oggetto predefinito creato dal sistema di I/O, in base al nome del servizio.
lpDisplayName
Nome visualizzato da usare dai programmi di controllo del servizio per identificare il servizio. La lunghezza massima della stringa è 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.
Commenti
Le informazioni di configurazione per un servizio vengono inizialmente specificate quando il servizio viene creato da una chiamata alla funzione CreateService . Le informazioni possono essere modificate chiamando la funzione ChangeServiceConfig .
Esempio
Per un esempio, vedere Esecuzione di query sulla configurazione di un servizio.
Nota
L'intestazione winsvc.h definisce QUERY_SERVICE_CONFIG come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del 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] |
| Intestazione | winsvc.h (include Windows.h) |