Datasnap.Win.ObjBrkr.TSimpleObjectBroker.GetComputerForProgID

Übergeordnet: TSimpleObjectBroker

Delphi

function GetComputerForProgID(const ProgID): string; override;

C++

virtual System::UnicodeString __fastcall GetComputerForProgID(const void *ProgID);

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Datasnap.Win.ObjBrkr.pas Datasnap.Win.ObjBrkr.hpp	Datasnap.Win.ObjBrkr	TSimpleObjectBroker

Beschreibung

Gibt einen String zurück, der einen verfügbaren Server-Computer bezeichnet.

Mit GetComputerForProgID kann der Name eines verfügbaren Server-Computers ermittelt werden. Der Parameter ProgID, der die gewünschte Serverschnittstelle bezeichnet, wird ignoriert.

TSimpleObjectBroker gibt den Wert der Eigenschaft ComputerName eines verfügbaren Servers aus der Eigenschaft Servers zurück. Wenn die Eigenschaft LoadBalanced den Wert true hat, wird der Server zufallsgesteuert aus den verfügbaren Servern ausgewählt. Wenn LoadBalanced dagegen den Wert false hat, wird der erste verfügbare Server gewählt, der in der Eigenschaft Servers aufgelistet ist. Wenn keine Server verfügbar sind, löst GetComputerForGUID eine EBrokerException-Exception aus.

Ein Server gilt dann als verfügbar, wenn seine Eigenschaft Enabled den Wert true hat und seine Eigenschaft HasFailed den Wert false. HasFailed wird vom Broker automatisch auf false gesetzt, sobald dieser vom Verbindungsabbruch zum Server benachrichtigt wird.