Méthode UserControlService de la classe Win32_Service (Services Bureau à distance)

Article
06/12/2023

La méthode de classe WMIUserControlService tente d’envoyer un code de contrôle défini par l’utilisateur au service référencé.

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

Syntaxe

uint32 UserControlService(
  [in] uint8 ControlCode
);

Paramètres

ControlCode [in]: Spécifie des valeurs définies (de 128 à 255) qui fournissent des commandes de contrôle spécifiques à un utilisateur.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou toute autre valeur pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

0: La demande a été acceptée.
1: La demande n'est pas prise en charge.
2: L’utilisateur n’avait pas l’accès nécessaire.
3: Le service ne peut pas être arrêté car d'autres services en cours d'exécution en dépendent.
4: Le code de contrôle demandé n'est pas valide ou est inacceptable pour le service.
5: Le code de contrôle demandé ne peut pas être envoyé au service, car l’état du service (Win32_BaseService. State property) est égal à 0, 1 ou 2.
6: Le service n'a pas été démarré.
7: Le service n'a pas répondu à la demande de démarrage en temps voulu.
8: Échec inconnu lors du démarrage du service.
9: Le chemin du répertoire du fichier exécutable de service est introuvable.
10: Le service est déjà en cours d'exécution.
11: La base de données pour ajouter un nouveau service est verrouillée.
12: Une dépendance sur laquelle ce service s’appuie a été supprimée du système.
13: Le service n'a pas pu trouver le service nécessaire à partir d'un service dépendant.
14: Le service a été désactivé du système.
15: Le service ne dispose pas de l'authentification correcte pour être exécuté sur le système.
16: Ce service est supprimé du système.
17: Le service n’a pas de thread d’exécution.
18: Le service a des dépendances circulaires lorsqu’il démarre.
19: Un service s’exécute sous le même nom.
20: Le nom du service comporte des caractères non valides.
21: Des paramètres non valides ont été passés au service.
22: Le compte sous lequel ce service s’exécute n’est pas valide ou n’a pas les autorisations nécessaires pour exécuter le service.
23: Le service existe dans la base de données des services disponibles dans le système.
24: Le service est actuellement mis en pause dans le système.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
DLL	TSCfgWmi.dll

Voir aussi

Win32_Service
Classes du système d’exploitation
Win32_TerminalService

Share via