Datasnap.Win.ObjBrkr.TServerItem.HasFailed

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property HasFailed: Boolean read FHasFailed write FHasFailed;

C++

__property bool HasFailed = {read=FHasFailed, write=FHasFailed, nodefault};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Datasnap.Win.ObjBrkr.pas
Datasnap.Win.ObjBrkr.hpp
Datasnap.Win.ObjBrkr TServerItem

Description

Indique si une tentative de connexion avec la machine associée au serveur a échoué.

Quand des composants connexion n'arrivent pas à établir une connexion avec un serveur d'application, ils en informent l'agent objet en appelant SetConnectStatus. L'objet agent simple enregistre alors cette information en initialisant la propriété HasFailed a true.

Quand HasFailed a la valeur false, la valeur de la propriété ComputerName peut être fournie aux composants connexion par les méthodes GetComputerForGUID et GetComputerForProgID de l'agent objet. Quand HasFailed a la valeur true, l'élément serveur n'est pas renvoyé.

Dès qu'un serveur a échoué, il est supposé indisponible tant que l'application ne réinitialise pas explicitement sa propriété HasFailed à false.

N'utilisez pas la propriété HasFailed pour désactiver des éléments serveur. Utilisez plutôt la propriété Enabled qui permet de désactiver des serveurs pour d'autres motifs qu'un échec dans la connexion.

Remarque :  Même si HasFailed a la valeur true, l'élément serveur est renvoyé par la méthode FindServer de TServerCollection.

Voir aussi