QUERY_SERVICE_CONFIGW struttura (winsvc.h)

Contiene informazioni di configurazione per un servizio installato. Viene usato dalla funzione QueryServiceConfig .

Sintassi

typedef struct _QUERY_SERVICE_CONFIGW {
  DWORD  dwServiceType;
  DWORD  dwStartType;
  DWORD  dwErrorControl;
  LPWSTR lpBinaryPathName;
  LPWSTR lpLoadOrderGroup;
  DWORD  dwTagId;
  LPWSTR lpDependencies;
  LPWSTR lpServiceStartName;
  LPWSTR lpDisplayName;
} QUERY_SERVICE_CONFIGW, *LPQUERY_SERVICE_CONFIGW;

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.

dwStartType

Quando avviare il servizio. Questo membro può essere uno dei valori seguenti.

dwErrorControl

Gravità dell'errore e dell'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 del carico a cui appartiene il servizio. Se il membro è NULL o una stringa vuota, il servizio non appartiene a un gruppo di ordinamento del carico.

Il programma di avvio usa i gruppi di ordinamento del carico per caricare i gruppi di servizi in un ordine specificato rispetto agli altri gruppi. L'elenco dei gruppi di ordinamento del carico è contenuto nel valore del Registro di sistema seguente:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder

dwTagId

Valore di tag univoco per questo servizio nel gruppo specificato dal parametro lpLoadOrderGroup . Un valore pari a zero indica che il servizio non è stato assegnato un tag. È possibile usare un tag per l'avvio del servizio all'interno di un gruppo di ordini di carico specificando un vettore di ordine tag nel Registro di sistema che si trova in:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList

I tag vengono valutati solo per SERVICE_KERNEL_DRIVERe SERVICE_FILE_SYSTEM_DRIVER tipi di servizi con SERVICE_BOOT_STARTo SERVICE_SYSTEM_START tipi di avvio.

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 è terminata con valore null doubly. 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 differenziarlo da un nome del servizio, poiché 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 dipende dall'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 in cui verrà eseguito il processo di servizio come quando viene eseguito. Questo nome può essere del nomeutentedi dominio\ modulo. Se l'account appartiene al dominio predefinito, il nome può essere del formato .\UserName. Il nome può essere anche "LocalSystem" se il processo è in esecuzione nell'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, che il sistema di input e output (I/O) usa 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 utilizzare dai programmi di controllo del servizio per identificare il servizio. La lunghezza massima della stringa è di 256 caratteri. Il nome viene mantenuto senza maiuscole/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.

Requisiti

Vedi anche

ChangeServiceConfig

CreateService

QueryServiceConfig

Startservice