Datasnap.Win.SConnect.ITransport.GetWaitEvent
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.