Win32_SystemDriver clase

  • Artículo

La Win32_SystemDriverclase WMI representa el controlador del sistema para un servicio base.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades y los métodos están en orden alfabético, no en orden MOF.

Sintaxis

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  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;
};

Miembros

La clase Win32_SystemDriver tiene estos tipos de miembros:

Métodos

La clase Win32_SystemDriver tiene estos métodos.

Método Descripción
Cambio Método de clase que modifica un servicio.
ChangeStartMode Método de clase que modifica el modo de inicio de un servicio.
Crear Método de clase que crea un nuevo servicio.
Eliminar Método de clase que elimina un servicio existente.
InterrogateService Método de clase que solicita que el servicio actualice su estado al administrador de servicios.
PauseService Método de clase que intenta colocar el servicio en estado en pausa.
ResumeService Método de clase que intenta colocar el servicio en el estado reanudado.
StartService Método de clase que intenta colocar el servicio en su estado de inicio.
StopService Método de clase que coloca el servicio en el estado detenido.
UserControlService Método de clase que intenta enviar un código de control definido por el usuario a un servicio.

 

Propiedades

La clase Win32_SystemDriver tiene estas propiedades.

AcceptPause

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Service Accepts Pause")

El servicio se puede pausar.

Esta propiedad se hereda de Win32_BaseService.

AcceptStop

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio | SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service Accepts Stop")

El servicio se puede detener.

Esta propiedad se hereda de Win32_BaseService.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción breve del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: CIM_Key, DisplayName ("Nombre de clase")

Nombre de la primera clase concreta que aparece en la cadena de herencia utilizada en la creación de una instancia. Cuando se usa con las demás propiedades clave de la clase , esta propiedad permite identificar de forma única todas las instancias de esta clase y sus subclases.

Esta propiedad se hereda de CIM_Service.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

DesktopInteract

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio | QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Interactúa con el escritorio")

Este servicio puede crear o comunicarse con ventanas en el escritorio.

Esta propiedad se hereda de Win32_BaseService.

DisplayName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio | QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Nombre para mostrar")

Nombre para mostrar del servicio. Esta cadena tiene una longitud máxima de 256 caracteres. El nombre se conserva entre mayúsculas y minúsculas en service Control Manager. Las comparaciones de DisplayName siempre no distinguen mayúsculas de minúsculas.

Restricciones: acepta el mismo valor que la propiedad Name .

Ejemplo: "Atdisk"

Esta propiedad se hereda de Win32_BaseService.

ErrorControl

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio | QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Gravedad del error de inicio")

Gravedad del error si este servicio no se inicia durante el inicio. Este valor indica la acción realizada por el programa de inicio si se produce un error. El sistema registra todos los errores.

Esta propiedad se hereda de Win32_BaseService.

Omitir ("Omitir")

No se notifica al usuario.

Normal ("Normal")

Se notifica al usuario.

Grave ("Grave")

El sistema se reinicia con la última configuración válida conocida.

Crítico ("Crítico")

El sistema intenta reiniciarse con una configuración válida.

Desconocido ("Desconocido")

Se desconoce la causa del error.

ExitCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Código de salida")

Código de error de Windows que define los problemas detectados al iniciar o detener el servicio. Esta propiedad se establece en ERROR_SERVICE_SPECIFIC_ERROR (1066) si el error es exclusivo del servicio representado por esta clase y hay información disponible sobre el error en la propiedad ServiceSpecificExitCode . El servicio establece este valor en NO_ERROR cuando se ejecuta y de nuevo tras la finalización normal.

Esta propiedad se hereda de Win32_BaseService.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Se instaló el objeto . Esta propiedad no necesita un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Clave

Identificador único del servicio que proporciona una indicación de la funcionalidad administrada. Esta funcionalidad se describe con más detalle en la propiedad Description del objeto.

Esta propiedad se hereda de CIM_Service.

PathName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Nombre de ruta de acceso de archivo")

Ruta de acceso completa al archivo binario del servicio que implementa el servicio.

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

Esta propiedad se hereda de Win32_BaseService.

ServiceSpecificExitCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Código de salida específico del servidor")

Código de error específico del servicio para los errores que se producen mientras el servicio se inicia o se detiene. Los códigos de salida se definen mediante el servicio representado por esta clase. Este valor solo se establece cuando el valor de la propiedad ExitCode es ERROR_SERVICE_SPECIFIC_ERROR (1066).

Esta propiedad se hereda de Win32_BaseService.

ServiceType

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Tipo de servicio")

Tipo de servicio proporcionado a los procesos de llamada.

Esta propiedad se hereda de Win32_BaseService.

Los valores son:

Controlador kernel ("Controlador de kernel")

Controlador del sistema de archivos ("Controlador del sistema de archivos")

Adaptador ("Adaptador")

Controlador Recognizer ("Controlador Recognizer")

Propio proceso ("Proceso propio")

Proceso de recurso compartido ("Proceso de recurso compartido")

Proceso interactivo ("Proceso interactivo")

Introducción

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Started")

Se ha iniciado el servicio.

Esta propiedad se hereda de CIM_Service.

StartMode

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Modo de inicio")

Modo de inicio del controlador del sistema.

Esta propiedad se hereda de Win32_BaseService.

Arranque ("Arranque")

Controlador de dispositivo iniciado por el cargador del sistema operativo (válido solo para los servicios de controlador).

Sistema ("Sistema")

Controlador de dispositivo iniciado por el proceso de inicialización del sistema operativo. Este valor solamente es válido para servicios de controladores.

Auto ("Auto")

El administrador de control de servicios iniciará automáticamente el servicio durante el inicio del sistema.

Manual ("Manual")

El administrador de control de servicios iniciará el servicio cuando un proceso llama al método StartService .

Deshabilitado ("Deshabilitado ")

Servicio que ya no se puede iniciar.

StartName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Nombre de la cuenta de inicio")

Nombre de cuenta con el que se ejecuta el servicio. Dependiendo del tipo de servicio, el nombre de la cuenta puede estar en forma de NombreDeDominio\NombreDeUsuario. El proceso de servicio se registrará con uno de estos dos formularios cuando se ejecute. Si la cuenta pertenece al dominio integrado, se puede especificar .\Username. Si se especifica NULL , el servicio se iniciará sesión como cuenta localSystem. En el caso de los controladores de nivel de sistema o kernel, StartName contiene el nombre del objeto de controlador (es decir, \FileSystem\Rdr o \Driver\Xns) que usa el sistema de entrada y salida (E/S) para cargar el controlador del dispositivo. Además, si se especifica NULL , el controlador se ejecuta con un nombre de objeto predeterminado creado por el sistema de E/S basado en el nombre del servicio.

Ejemplo: "DWDOM\Administración"

Esta propiedad se hereda de Win32_BaseService.

State

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Estado actual del servicio base.

Esta propiedad se hereda de Win32_BaseService.

Los valores son:

Detenido ("Detenido")

Iniciar pendiente ("Iniciar pendiente")

Detener pendiente ("Detener pendiente")

En ejecución ("En ejecución")

Continuar pendiente ("Continuar pendiente")

Pausa pendiente ("Pausa pendiente")

En pausa ("En pausa")

Desconocido ("Desconocido")

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10), DisplayName ("Status")

Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Error previo" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predecir un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Inicio", "Detención" y "Servicio". Este último, "Servicio", podría aplicarse durante la resilveración de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "CORRECTO" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nombre de clase del sistema")

Escriba el nombre del sistema que hospeda este servicio.

Esta propiedad se hereda de CIM_Service.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. Name"), CIM_Key, DisplayName ("Nombre del sistema")

Nombre del sistema que hospeda este servicio.

Esta propiedad se hereda de CIM_Service.

TagId

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Estructuras de servicio| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("Id. de etiqueta")

Valor de etiqueta único para este servicio en el grupo. Un valor de 0 (cero) indica que no se ha asignado una etiqueta al servicio. Una etiqueta se puede usar para ordenar el inicio del servicio dentro de un grupo de pedidos de carga especificando un vector de orden de etiqueta en el registro ubicado en:

Esta propiedad se hereda de Win32_BaseService.

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList.

Las etiquetas solo se evalúan para los servicios de tipo de inicio controlador de kernel y controlador del sistema de archivos que tienen modos de inicio de arranque o sistema.

Comentarios

La clase Win32_SystemDriver se deriva de Win32_BaseService.

Ejemplos

En el ejemplo Enumerar controladores del sistema VBScript se muestran los controladores del sistema instalados en un archivo HTML.

En el siguiente ejemplo de PowerShell se recuperan varias propiedades de los controladores de sistema en ejecución en un equipo.

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Espacio de nombres
 Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

Win32_BaseService

Clases de sistema operativo