Cambiar método de la clase Win32_BaseService

Artículo
06/03/2023

El método declase Change WMI modifica un objeto de servicio derivado de Win32_BaseService. El parámetro Win32_LoadOrderGroup representa un grupo de servicios del sistema que definen las dependencias de ejecución. Los servicios se deben iniciar en el orden especificado por el grupo de pedidos de carga, ya que los servicios dependen entre sí. Estos servicios dependientes requieren servicios antecedentes para funcionar correctamente.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

uint32 Change(
  [in] string  DisplayName,
  [in] string  PathName,
  [in] uint8   ServiceType,
  [in] uint8   ErrorControl,
  [in] string  StartMode,
  [in] boolean DesktopInteract,
  [in] string  StartName,
  [in] string  StartPassword,
  [in] string  LoadOrderGroup,
  [in] string  LoadOrderGroupDependencies[],
  [in] string  ServiceDependencies[]
);

Parámetros

DisplayName [in]

Nombre para mostrar de un servicio. Esta cadena tiene una longitud máxima de 256 caracteres. El nombre se conserva entre mayúsculas y minúsculas en el administrador de control de servicios. Las comparaciones displayName siempre no distinguen mayúsculas de minúsculas.

Restricciones: acepta el mismo valor que el parámetro Name .

Ejemplo: "Atdisk".

PathName [in]

Ruta de acceso completa al archivo ejecutable que implementa un servicio.

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

ServiceType [in]

Tipo de servicios proporcionados a procesos que los llaman.

Controlador kernel (1)

Controlador del sistema de archivos (2)

Adaptador (4)

Controlador Recognizer (8)

Proceso propio (16)

Proceso de uso compartido (32)

(256)

Proceso interactivo

ErrorControl [in]

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

Omitir (0)

No se notifica al usuario.

Normal (1)

Normal. Se notifica al usuario.

Grave (2)

El sistema se reinicia con la última configuración correcta.

Crítico (3)

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

StartMode [in]

Modo de inicio del servicio base de Windows.

Inicio de arranque ("Arranque")

Controlador de dispositivo que se inicia el cargador del sistema operativo.

Inicio del 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.

Inicio automático ("Automático")

Servicio que el administrador de control de servicios inicia automáticamente durante el inicio del sistema.

Inicio de la demanda ("Manual")

Servicio para comenzar por el administrador de controles de servicio cuando un proceso llama al método StartService .

Deshabilitado ("Deshabilitado")

Servicio que no se puede iniciar.

DesktopInteract [in]

Si es True, el servicio puede crear o comunicarse con una ventana en el escritorio.

StartName [in]

Nombre de cuenta en el que se ejecuta el servicio, que depende del tipo de servicio. El nombre de la cuenta puede estar en forma de NombreDeDominio\NombreDeUsuario o .\NombreDeUsuario. Cuando se ejecuta, el proceso de servicio se registra mediante uno de los dos formularios anteriores. Si la cuenta pertenece al dominio integrado, se puede especificar .\Username. Si se especifica una cadena vacía, el servicio se inicia sesión como la cuenta LocalSystem. En el caso de los controladores de nivel de sistema o kernel, StartName contiene el nombre del objeto de controlador, por ejemplo, \FileSystem\Rdr o \Driver\Xns, que el sistema de entrada y salida (E/S) usa para cargar el controlador del dispositivo. Si se especifica NULL, el controlador se ejecuta con un nombre de objeto predeterminado que el sistema de E/S crea en función del nombre del servicio, por ejemplo, DWDOM\Administración.

También puede usar el formato De nombre principal de usuario (UPN) para especificar el NombreDeInstancia, por ejemplo, Username@DomainName.

StartPassword [in]

Contraseña al nombre de cuenta que especifica el parámetro StartName . Especifique NULL cuando no cambie la contraseña. Especifique una cadena vacía si el servicio no tiene una contraseña.

Nota

Al cambiar un servicio de un sistema local a una red o de una red a un sistema local, StartPassword debe ser una cadena vacía ("") y no NULL.

LoadOrderGroup [in]

Nombre de grupo al que está asociado. Los grupos de orden de carga se encuentran en el registro del sistema y determinan la secuencia que los servicios se cargan en un sistema operativo. Si el puntero es NULL o apunta a una cadena vacía, el servicio no pertenece a un grupo. Las dependencias entre grupos deben aparecer en el parámetro LoadOrderGroupDependencies . Los servicios de la lista de grupos de ordenación de carga se inician primero, seguidos de servicios en grupos que no están en la lista de grupos de ordenación de carga, seguidos de servicios que no pertenecen a un grupo. El registro del sistema tiene una lista de grupos de ordenación de carga ubicados en HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder.

LoadOrderGroupDependencies [in]

Lista de grupos de ordenación de carga que deben iniciarse antes de que se inicie este servicio. La matriz termina doblemente en null. Si el puntero es NULL o si apunta a una cadena vacía, el servicio no tiene dependencias. Los nombres de grupo deben tener el prefijo SC_GROUP_IDENTIFIER (definido en el archivo Winsvc.h) para diferenciarlos de los nombres de servicio, ya que los servicios y los grupos de servicios comparten el mismo espacio de nombres. La dependencia de un grupo significa que este servicio se puede ejecutar si al menos un miembro del grupo se está ejecutando después de un intento de iniciar todos los miembros del grupo.

ServiceDependencies [in]

Lista que contiene los nombres de los servicios que deben iniciarse antes de que se inicie este servicio. La matriz termina doblemente en null. Si el puntero es NULL o apunta a una cadena vacía, el servicio no tiene dependencias. La dependencia de un servicio significa que este servicio solo se puede ejecutar si el servicio del que depende está en ejecución.

Valor devuelto

Devuelve uno de los valores enumerados en la lista siguiente o un valor diferente para indicar un error.

Success

Se acepta la solicitud.

No compatible

No se admite la solicitud.

Acceso denegado

El usuario no tiene los privilegios de acceso necesarios.

Servicios dependientes en ejecución

No se puede detener el servicio porque otros servicios que se están ejecutando dependen de él.

Control de servicio no válido

El código de control solicitado no es válido o no es aceptable para el servicio.

El servicio no puede aceptar el control

El código de control solicitado no se puede enviar al servicio porque la propiedad State del objeto Win32_BaseService es igual a 0, 1 o 2.

Servicio no activo

El servicio no se ha iniciado.

Tiempo de espera de solicitud de servicio

El servicio no responde rápidamente a la solicitud de inicio.

Error desconocido

Proceso interactivo.

Ruta de acceso no encontrada

No se encuentra la ruta de acceso del directorio al archivo ejecutable del servicio.

El servicio ya se está ejecutando

El servicio ya se está ejecutando.

Base de datos de servicio bloqueada

La base de datos para agregar un nuevo servicio está bloqueada.

Dependencia de servicio eliminada

Dependencia para la que se basa este servicio se quita del sistema.

Error de dependencia del servicio

El servicio no encuentra el servicio necesario desde un servicio dependiente.

Servicio deshabilitado

El servicio está deshabilitado desde el sistema.

Error de inicio de sesión del servicio

El servicio no tiene la autenticación correcta para ejecutarse en el sistema.

Servicio marcado para su eliminación

Este servicio se está quitando del sistema.

Servicio sin subproceso

No hay ningún subproceso de ejecución para el servicio.

Dependencia circular de estado

Hay dependencias circulares al iniciarse el servicio.

Nombre duplicado de estado

Hay un servicio que se ejecuta con el mismo nombre.

Estado Nombre no válido

Hay caracteres no válidos en el nombre del servicio.

Parámetro no válido de estado

Se han pasado parámetros no válidos al servicio.

Estado Cuenta de servicio no válida

La cuenta de este servicio en la que se va a ejecutar no es válida o no tiene los permisos para ejecutar el servicio.

El servicio de estado existe

El servicio existe en la base de datos de servicios disponibles del sistema.

El servicio ya está en pausa

El servicio se encuentra en pausa actualmente en el sistema.

Otros

25 4294967295

Observaciones

Para cambiar un servicio de una red a un sistema local, use los siguientes valores para los parámetros StartName e StartPassword :

StartName = "LocalSystem"
StartPassword = "" // - empty string, not NULL

Para cambiar un servicio de un sistema local a una red, use los valores siguientes para los parámetros StartName e StartPassword :

StartName = "NT AUTHORITY\NetworkService"
StartPassword = "" // - empty string, not NULL

Requisitos

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

Vea también

Clases de sistema operativo
Win32_BaseService

Compartir a través de