Datasnap.Win.SConnect.ITransport.GetWaitEvent

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetWaitEvent: THandle; stdcall;

C++

virtual NativeUInt __stdcall GetWaitEvent() = 0 ;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Datasnap.Win.SConnect.pas
Datasnap.Win.SConnect.hpp
Datasnap.Win.SConnect ITransport

Beschreibung

Gibt das Handle eines Ereignisobjekts zurück, das von dem Objekt verwaltet wird, das ITransport implementiert.

Stream-Verbindungskomponenten wickeln sämtliche Lese- und Schreibvorgänge vom und zum Anwendungsserver in einem separaten Thread ab. Dadurch wird der Einfluss begrenzt, den die Kommunikation mit dem Anwendungsserver auf die Geschwindigkeit der Client-Anwendung hat. Grund dafür ist, dass die Ausführung nicht unterbrochen werden muss, während das Marshaling oder das Senden und Empfangen von Botschaften stattfindet. Die Stream-Verbindungskomponente muss den Einsatz des Kommunikations-Threads koordinieren. Dafür wird ein Ereignisobjekt verwendet, das ein Element des Objekts ist, das ITransport implementiert.

GetWaitEvent gibt ein Handle auf dieses Ereignisobjekt zurück. Ein TEvent-Objekt muss beim Implementieren eines Objekts, das ITransport unterstützt, als ein Element dieses Objektes erstellt und dessen Handle als Rückgabewert von GetWaitEvent übergeben werden. Das Ereignisobjekt darf nicht für interne Zwecke eingesetzt werden, sonst stört es die Verwendung des Ereignisses durch die Stream-Verbindungskomponente.

Siehe auch