Modifier la méthode de la _ classe SystemDriver Win32

La méthode change WMI Class modifie un service _ SystemDriver Win32 . Le paramètre _ LoadOrderGroup Win32 représente un regroupement de services système définissant les dépendances d’exécution. Les services doivent être lancés dans l’ordre spécifié par le groupe d’ordre de chargement, car les services dépendent les uns des autres. Ces services dépendants requièrent la présence des services antécédents pour fonctionner correctement.

Cette rubrique utilise la syntaxe format MOF (MOF). Pour plus d’informations sur l’utilisation de cette méthode, consultez appel d’une méthode.

Syntaxe

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[]
);

Paramètres

DisplayName [ dans]

Nom d’affichage du service. Cette chaîne a une longueur maximale de 256 caractères. Le nom est conservé dans le gestionnaire de contrôle des services. Les comparaisons DisplayName ne respectent jamais la casse.

Contraintes : accepte la même valeur que le paramètre Name .

Exemple : « Atdisk »

Nom du chemin [ dans]

Chemin d’accès qualifié complet au fichier exécutable qui implémente le service.

Exemple : \ racine_système \ System32 \ drivers \afd.sys

ServiceType [ dans]

Type des services fournis aux processus qui les appellent.

1 (0x1)

Pilote du noyau

2 (0X2)

Pilote du système de fichiers

4 (0x4)

Adaptateur

8 (0x8)

Pilote de reconnaissance

16 (0x10)

Propre processus

32 (0x20)

Processus de partage

256 (0x100)

Processus interactif

ErrorControl [ dans]

Gravité de l’erreur si ce service ne parvient pas à démarrer au démarrage. La valeur indique l’action entreprise par le programme de démarrage en cas d’échec. Toutes les erreurs sont consignées par le système.

Ignorer (0)

L'utilisateur n'est pas notifié.

Normal (1)

Normal. L'utilisateur est notifié.

Grave (2)

Le système est redémarré avec la dernière bonne configuration.

Critique (3)

Le système tente de redémarrer avec une bonne configuration.

StartMode [ dans]

mode de démarrage du service de base Windows.

Démarrage du démarrage

Pilote de périphérique Démarré par le chargeur du système d’exploitation.

Démarrage du démarrage

Pilote de périphérique Démarré par le chargeur du système d’exploitation.

Démarrage du système

Pilote de périphérique Démarré par le processus d’initialisation du système d’exploitation. Cette valeur est uniquement valide pour les services de pilote.

Démarrage automatique

Service pour démarrer automatiquement par le gestionnaire de contrôle des services lors du démarrage du système.

Début de la demande

Service à démarrer par le gestionnaire de contrôle des services lorsqu’un processus appelle la méthode StartService .

Activée

Service qui ne peut pas être démarré.

DesktopInteract [ dans]

Valeur qui, si la valeur est true, le service peut créer ou communiquer avec les fenêtres sur le bureau.

StartName [ dans]

Nom du compte sous lequel le service s’exécute. Selon le type de service, le nom du compte peut se présenter sous la forme nom_domaine \ nom_utilisateur ou. \ Nom d’utilisateur. Lorsqu’il s’exécute, le processus de service est enregistré à l’aide de l’une de ces deux formes. Si le compte appartient au domaine intégré,. \ Le nom d’utilisateur peut être spécifié. Si une chaîne vide est spécifiée, le service est connecté en tant que compte LocalSystem. Pour les pilotes au niveau du noyau ou du système, StartName contient le nom d’objet du pilote, par exemple, le \ système de fichiers \ RDR ou \ \ le pilote XNS), que le système d’entrée et de sortie (e/s) utilise pour charger le pilote de périphérique. Si null est spécifié, le pilote s’exécute avec un nom d’objet par défaut créé par le système d’e/s en fonction du nom du service, par exemple, \ administrateur DWDOM.

Vous pouvez également utiliser le format UPN (user principal name) pour spécifier le StartName, par exemple, Username@DomainName .

StartPassword [ dans]

Mot de passe du nom de compte spécifié par le paramètre StartName . Spécifiez null si vous ne modifiez pas le mot de passe. Spécifiez une chaîne vide si le service ne possède pas de mot de passe.

Notes

Lorsque vous modifiez un service d’un système local à un réseau ou d’un réseau à un système local, StartPassword doit être une chaîne vide ("") et non null.

LoadOrderGroup [ dans]

Nom du groupe auquel il est associé. Les groupes d’ordre de chargement sont contenus dans le registre système et déterminent l’ordre dans lequel les services sont chargés dans le système d’exploitation. Si le pointeur a la valeur null, ou s’il pointe vers une chaîne vide, le service n’appartient pas à un groupe. Les dépendances entre les groupes doivent être listées dans le paramètre LoadOrderGroupDependencies . Les services de la liste de groupes d’ordre de chargement sont démarrés en premier, suivis par des services dans des groupes qui ne figurent pas dans la liste des groupes d’ordre de chargement, suivis par des services qui n’appartiennent pas à un groupe. La liste des groupes d’ordre de chargement se trouve dans le registre système à l’emplacement suivant :

HKEY _ _ \ \ \ Contrôle CurrentControlSet du système \ de l’ordinateur local ServiceGroupOrder

LoadOrderGroupDependencies [ dans]

Liste des groupes d’ordre de chargement qui doivent démarrer avant le démarrage de ce service. Le tableau se termine par un caractère double null. Si le pointeur a la valeur null, ou s’il pointe vers une chaîne vide, le service n’a pas de dépendances. Les noms de groupes doivent être préfixés par l' _ _ identificateur de groupe SC (défini dans le fichier WinSvc. h) pour les différencier des noms de service, car les services et les groupes de services partagent le même espace de noms. La dépendance sur un groupe signifie que ce service peut s’exécuter si au moins un membre du groupe est en cours d’exécution après une tentative de démarrage de tous les membres du groupe.

ServiceDependencies [ dans]

Liste qui contient les noms des services qui doivent démarrer avant le démarrage de ce service. Le tableau se termine par un caractère double null. Si le pointeur a la valeur null, ou s’il pointe vers une chaîne vide, le service n’a pas de dépendances. La dépendance sur un service signifie que ce service ne peut s’exécuter que si le service dont il dépend est en cours d’exécution.

Valeur de retour

Retourne la valeur zéro (0) si le service a été correctement modifié, 1 (un) si la demande n’est pas prise en charge, et tout autre nombre pour indiquer une erreur.

Opération réussie (0)

Non pris en charge (1)

Accès refusé (2)

Services dépendants en cours d’exécution (3)

Contrôle de service non valide (4)

Le service ne peut pas accepter le contrôle (5)

Service non actif (6)

Délai d’expiration de la demande de service (7)

Échec inconnu (8)

Chemin introuvable (9)

Service déjà en cours d’exécution (10)

Base de données de service verrouillée (11)

Dépendance de service supprimée (12)

Échec de la dépendance du service (13)

Service désactivé (14)

Échec de l’ouverture de session du service (15)

Service marqué pour suppression (16)

Service sans thread (17)

Dépendance circulaire d’État (18)

Nom de l’État en double (19)

Nom de l’état non valide (20)

Paramètre d’État non valide (21)

Compte de service de l’état non valide (22)

Le service d’État existe (23)

Service déjà suspendu (24)

Autre (25 4294967295)

Notes

Pour modifier un service à partir d’un service réseau sur le système local, utilisez les valeurs suivantes pour les paramètres StartName et StartPassword :

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

Pour modifier un service d’un service système local en service réseau, utilisez les valeurs suivantes pour les paramètres StartName et StartPassword :

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
\Cimv2 racine
En-tête
Mbnapi. h
MOF
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

Classes du système d’exploitation

_SystemDriver Win32