classe Win32_BaseService

Articolo
06/12/2023

La classe WMI astratta Win32_BaseService rappresenta gli oggetti eseguibili installati in un database del Registro di sistema gestito da Service Control Manager. Il file eseguibile associato a un servizio può essere avviato al momento dell'avvio da un programma di avvio o dal sistema. Può anche essere avviato su richiesta da Service Control Manager. Qualsiasi servizio o processo che non è di proprietà di un utente specifico e che fornisce un'interfaccia a alcune funzionalità supportate dal sistema computer, è un discendente (o membro) di questa classe.

Esempio: servizio client DHCP (Dynamic Host Configuration Protocol) in un sistema computer che esegue Windows Server.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate nell'ordine alfabetico, non nell'ordine MOF.

Sintassi

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Members

La classe Win32_BaseService include questi tipi di membri:

Metodi
Proprietà

Metodi

La classe Win32_BaseService include questi metodi.

Metodo	Descrizione
Cambiare	Modifica un servizio.
ChangeStartMode	Modifica la modalità di avvio di un servizio.
Crea	Crea un nuovo servizio.
Elimina	Elimina un servizio esistente.
InterrogateService	Richiede che il servizio aggiorni lo stato al service manager.
PauseService	Esegue un tentativo di sospensione del servizio.
ResumeService	Esegue un tentativo di ripresa del servizio.
Startservice	Tenta di inserire il servizio nello stato di avvio.
StopService	Metodo di classe che inserisce il servizio nello stato arrestato.
UserControlService	Tenta di inviare un codice di controllo definito dall'utente a un servizio.

Proprietà

La classe Win32_BaseService ha queste proprietà.

AcceptPause

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Service Accetta pausa")

Il servizio può essere sospeso.

AcceptStop

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service Accetta stop")

Il servizio può essere arrestato.

Didascalia

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MaxLen (64), DisplayName ("Didascalia")

Breve descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

CreationClassName

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: CIM_Key, DisplayName ("Nome classe")

Nome della prima classe concreta da visualizzare nella catena di ereditarietà usata nella creazione di un'istanza. Quando viene usato con le altre proprietà chiave della classe, la proprietà consente a tutte le istanze di questa classe e alle relative sottoclassi di essere identificate in modo univoco.

Questa proprietà viene ereditata da CIM_Service.

Descrizione

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Descrizione")

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

DesktopInteract

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Interagisce con Desktop")

Il servizio può creare o comunicare con finestre sul desktop.

DisplayName

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Nome visualizzato")

Nome visualizzato del servizio. La lunghezza massima della stringa è di 256 caratteri. Il nome viene mantenuto in caso di maiuscole e minuscole in Service Control Manager. I confronti di DisplayName sono sempre senza distinzione tra maiuscole e minuscole.

Vincoli: accetta lo stesso valore della proprietà Name .

Esempio: "Atdisk"

ErrorControl

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Gravità dell'errore di avvio")

Gravità dell'errore. Il servizio non viene avviato. Il valore indica l'azione eseguita dal programma di avvio se si verifica un errore. Tutti gli errori vengono registrati dal computer.

Ignora ("Ignora ")

L'utente non viene notificato.

Normale ("Normale ")

L'utente viene notificato.

Grave ("Grave ")

Il sistema è stato riavviato con l'ultima configurazione nota.

Critico ("Critico ")

Il sistema tenta un riavvio con una configurazione valida.

Sconosciuto ("sconosciuto ")

L'azione eseguita non è specificata.

ExitCode

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Exit Code")

Definizione di eventuali problemi riscontrati durante l'avvio o l'arresto del servizio. Questa proprietà viene impostata su ERROR_SERVICE_SPECIFIC_ERROR (1066) quando l'errore è univoco per il servizio rappresentato da questa classe. Le informazioni relative all'errore sono disponibili nella proprietà ServiceSpecificExitCode . Il servizio imposta questo valore su NO_ERROR durante l'esecuzione e nuovamente al termine della normale terminazione.

InstallDate

Tipo di dati: datetime
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("MIF). DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")

L'oggetto è stato installato. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Nome

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: Chiave

Identificatore univoco del servizio, che fornisce un'indicazione della funzionalità gestita. Questa funzionalità è descritta in modo più dettagliato nella proprietà Description dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

PathName

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Nome percorso file")

Percorso completo del file binario del servizio che implementa il servizio.

Esempio: "\SystemRoot\System32\drivers\afd.sys"

ServiceSpecificExitCode

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Codice di uscita specifico del server")

Codice di errore specifico del servizio per gli errori che si verificano durante l'avvio o l'arresto del servizio. I codici di uscita sono definiti dal servizio rappresentato da questa classe. Questo valore viene impostato solo quando il valore ExitCodeproperty è ERROR_SERVICE_SPECIFIC_ERROR (1066).

ServiceType

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Tipo di servizio")

Servizio fornito ai processi chiamante.

Driver del kernel ("Driver kernel")

Driver file system ("driver file system")

Adapter ("Adapter ")

Driver di riconoscimento ("Riconoscimento driver ")

Processo personalizzato ("processo proprio")

Processo di condivisione ("Processo di condivisione")

Processo interattivo ("Processo interattivo")

Avviato

Tipo di dati: booleano
Tipo di accesso: sola lettura
Qualificatori: DisplayName ("Avviato")

Il servizio è stato avviato.

Questa proprietà viene ereditata da CIM_Service.

Modalità avvio

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: Override ("StartMode"), DisplayName ("Modalità start")

Modalità di avvio del servizio di base di Windows.

Questa proprietà viene ereditata da CIM_Service.

Avvio ("avvio ")

Driver di dispositivo avviato dal caricatore del sistema operativo (valido solo per i servizi driver).

Sistema ("Sistema ")

Driver del dispositivo avviato dal processo di inizializzazione del sistema operativo. Questo valore è valido solo per i servizi del driver.

Auto ("Auto ")

Servizio da avviare automaticamente dal gestore del controllo del servizio durante l'avvio del sistema.

Manuale ("Manuale")

Servizio da avviare dal gestore di controllo del servizio quando un processo chiama il metodo StartService .

Disabilitato ("Disabilitato ")

Servizio che non può più essere avviato.

StartName

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Nome account iniziale")

Nome dell'account in cui viene eseguito il servizio. A seconda del tipo di servizio, il nome dell'account può essere sotto forma di formato "DomainName\Username" o UPN (Username@DomainName). Il processo di servizio verrà registrato usando uno di questi due moduli durante l'esecuzione. Se l'account appartiene al dominio predefinito, è possibile specificare ".\Username". Se viene specificato NULL , il servizio verrà eseguito come account LocalSystem. Per i driver a livello di kernel o di sistema, StartName contiene 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. Inoltre, se viene specificato NULL , il driver viene eseguito con un nome di oggetto predefinito creato dal sistema di I/O in base al nome del servizio. Esempio: "DWDOM\Amministrazione".

State

Tipo di dati: stringa
Tipo di accesso: Lettura/scrittura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | SERVICE_STATUS|dwCurrentState "), DisplayName ("Stato")

Stato corrente del servizio di base.

Arrestato ("Arrestato ")

Avvia in sospeso ("Avvia in sospeso ")

Arresta in sospeso ("Arresta in sospeso ")

Esecuzione ("in esecuzione ")

Continuare in sospeso ("Continua in sospeso ")

Sospendere l'sospeso ("Sospendere in sospeso ")

Sospeso ("Sospeso ")

Sconosciuto ("sconosciuto ")

Windows Server 2008 e Windows Vista: Questa proprietà è di sola lettura.

Status

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: MaxLen (10), DisplayName ("Status")

Stato corrente dell'oggetto. È possibile definire vari stati operativi e non operativi. Gli stati operativi includono: "OK", "Degraded" e "Pred Fail" (un elemento, ad esempio un disco rigido abilitato per SMART, può funzionare correttamente, ma stimare un errore nel prossimo futuro). Gli stati non operativi includono: "Error", "Starting", "Arresta" e "Servizio". Quest'ultimo, "Servizio", può essere applicato durante il ridimensionamento mirror di un disco, il ricaricamento di un elenco di autorizzazioni utente o altri lavori amministrativi. Non tutti questi lavori sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore")

Degradato ("degradato ")

Sconosciuto ("sconosciuto ")

Pred Fail ("Pred Fail ")

Avvio ("Avvio ")

Arresto ("Arresto")

Servizio ("Servizio ")

Sottolineato ("stressato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

SystemCreationClassName

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nome classe di sistema")

Nome del sistema che ospita questo servizio.

Questa proprietà viene ereditata da CIM_Service.

Systemname

Tipo di dati: stringa
Tipo di accesso: sola lettura
Qualificatori: propagati ("CIM_System. Name"), CIM_Key, DisplayName ("Nome sistema")

Nome del sistema che ospita questo servizio.

Questa proprietà viene ereditata da CIM_Service.

TagId

Tipo di dati: uint32
Tipo di accesso: sola lettura
Qualificatori: MappingStrings ("Win32API| Strutture di servizio | QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Id tag")

Valore univoco del tag per questo servizio nel gruppo. Un valore pari a 0 (zero) indica che il servizio non è stato assegnato un tag. Un tag può essere usato per l'ordinamento del servizio star tup all'interno di un gruppo di ordini di carico specificando un vettore di ordine tag nel Registro di sistema situato in: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. I tag vengono valutati solo per i servizi di avvio del driver del kernel e del driver file system con modalità di avvio o avvio del sistema.

Commenti

La classe Win32_BaseService deriva da CIM_Service.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Radice\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

CIM_Service
Classi del sistema operativo

Condividi tramite

classe Win32_BaseService

Sintassi

Members

Metodi

Proprietà

Commenti

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive