System.Win.ComObj.InterfaceConnect

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure InterfaceConnect(const Source: IUnknown; const IID: TIID;
const Sink: IUnknown; var Connection: Longint);

C++

extern DELPHI_PACKAGE void __fastcall InterfaceConnect(const System::_di_IInterface Source, const GUID &IID, const System::_di_IInterface Sink, int &Connection);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.Win.ComObj.pas
System.Win.ComObj.hpp
System.Win.ComObj System.Win.ComObj

Beschreibung

Verbindet eine IConnectionPoint-Schnittstelle.

Durch einen Aufruf von InterfaceConnect in einer Client-Anwendung wird ein Objekt registriert, das eine ausgehende Server-Verbindung implementiert. Normalerweise ist dieses Objekt ein Ereignis-Pool, anhand dessen ein Client auf Server-Ereignisse reagiert. Wenn ein Ereignis ausgelöst wird, ruft der Server (Ereignisquelle) seine ausgehende Schnittstelle für dieses Ereignis auf, und der Client, der die Schnittstelle als Ereignis-Pool implementiert, empfängt den Aufruf.

InterfaceConnect erhält eine IConnectionPointContainer-Schnittstelle von einem COM-Server an einem bestimmten Verbindungspunkt. Mit IConnectionPoint kann der Server eine ausgehende Schnittstelle für ein Objekt setzen, normalerweise für einen Ereignis-Pool. IConnectionPointContainer zählt die Verbindungspunkte auf, die der Server unterstützt, damit aufrufende Aktionen den richtigen Verbindungspunkt finden können. Die IConnectionPointContainer- und IConnectionPoint-Schnittstellen umfassen die Standard-Ereignisbehandlung.

Source ist eine IUnknown-Schnittstelle für das Server-Objekt, das die ausgehende Schnittstelle definiert und aufruft.

IID ist die GUID der ausgehenden Schnittstelle.

Sink ist die IUnknown-Schnittstelle für das Client-Objekt, das die ausgehende Schnittstelle implementiert.

Connection gibt ein Token zurück, das die Verbindung repräsentiert. Das Token muss gespeichert werden, damit die Prozedur InterfaceDisconnect es zur Beendigung der von InterfaceConnect eingerichteten Verbindung verwenden kann.

Anmerkung:  Eine Demo zu dieser Prozedur finden Sie im Verzeichnis Demos/ActiveX.

Siehe auch