Partager via


ServiceBase.OnCustomCommand(Int32) Méthode

Définition

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 -> unit
Protected 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é.

S’applique à

Voir aussi