Win32_BaseService clase

  • Artículo

La Win32_BaseServiceclase WMI abstracta representa objetos ejecutables instalados en una base de datos del Registro mantenida por Service Control Manager. El archivo ejecutable asociado a un servicio se puede iniciar en tiempo de arranque mediante un programa de arranque o por el sistema. También puede iniciarse a petición por el Administrador de control de servicios. Cualquier servicio o proceso que no sea propiedad de un usuario específico y que proporcione una interfaz a alguna funcionalidad compatible con el sistema informático, es un descendiente (o miembro) de esta clase.

Ejemplo: el servicio de cliente del protocolo de configuración dinámica de host (DHCP) en un sistema de equipo que ejecuta Windows Server.

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

Sintaxis

[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;
};

Miembros

La clase Win32_BaseService tiene estos tipos de miembros:

Métodos

La clase Win32_BaseService tiene estos métodos.

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

Propiedades

La clase Win32_BaseService 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.

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.

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 otras propiedades clave de la clase , la 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")

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

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"

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. El servicio no se inicia. El valor indica la acción realizada por el programa de inicio si se produce un error. El sistema registra todos los errores.

Omitir ("Omitir")

No se notifica al usuario.

Normal ("Normal")

Se notifica al usuario.

Grave ("Grave")

El sistema se ha reiniciado con la última configuración correcta conocida.

Crítico ("Crítico")

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

Desconocido ("Desconocido")

No se especifica la acción realizada.

ExitCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

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

Definir 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.

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_ManagedSystemElement.

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"

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 exitCodeproperty es ERROR_SERVICE_SPECIFIC_ERROR (1066).

ServiceType

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Servicio proporcionado a los procesos de llamada.

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: Invalidación ("StartMode"), DisplayName ("Modo de inicio")

Modo de inicio del servicio base de Windows.

Esta propiedad se hereda de CIM_Service.

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 tener el formato "DomainName\Username" o el formato UPN (Username@DomainName). 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".

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.

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")

Windows Server 2008 y Windows Vista: Esta propiedad es de solo lectura.

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 los siguientes:

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. Se puede usar una etiqueta para ordenar el servicio star tup dentro de un grupo de pedidos de carga especificando un vector de orden de etiqueta en el registro ubicado en: 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_BaseService se deriva de CIM_Service.

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

CIM_Service

Clases de sistema operativo