ServiceBase.OnCustomCommand(Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Si elle est implémentée dans une classe dérivée, la méthode OnCustomCommand(Int32) s'exécute lorsque le Gestionnaire de contrôle des services (SCM) passe une commande personnalisée au service. Spécifie les actions à effectuer lorsqu'une commande a la valeur de paramètre spécifiée.
protected:
virtual void OnCustomCommand(int command);protected virtual void OnCustomCommand (int command);abstract member OnCustomCommand : int -> unit
override this.OnCustomCommand : int -> unitProtected Overridable Sub OnCustomCommand (command As Integer)Paramètres
- command
- Int32
Message de commande envoyé au service.
Remarques
OnCustomCommand vous permet de spécifier des fonctionnalités supplémentaires au-delà du démarrage, de l’arrêt, de la suspension et de la poursuite des services.
Le SCM n’examine pas la commande personnalisée pour vérifier si le service prend en charge le command paramètre passé. Il transmet directement la commande personnalisée au service. Si le service ne reconnaît pas le command paramètre, il ne fait rien.
Les commandes personnalisées sont déclenchées par une ExecuteCommand instruction dans un ServiceController composant. Utilisez une instruction switch ou if.. condition pour gérer les commandes personnalisées que vous définissez sur votre service.
Les seules valeurs d’une commande personnalisée que vous pouvez définir dans votre application ou utiliser OnCustomCommand sont celles comprises entre 128 et 255. Les entiers inférieurs à 128 correspondent aux valeurs réservées du système.
Si la AutoLog propriété est true, commandes personnalisées, comme toutes les autres commandes, écrivez des entrées dans le journal des événements pour signaler si l’exécution de la méthode a réussi ou échoué.