FireDAC.Comp.Client.TFDCustomConnection.CliHandle

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property CliHandle: Pointer read GetCliHandle;

C++

__property void * CliHandle = {read=GetCliHandle};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomConnection


Beschreibung

CLI-Handle für die gemeinsame Nutzung der Verbindung.

Die Eigenschaft CliHandle gibt ein DBMS-CLI-Verbindungs-Handle (Call Level Interface) zurück. Dieser Wert kann der Eigenschaft SharedCliHandle eines anderen TFDCustomConnection-Objekts zugewiesen werden. Damit können Sie eine Verbindung von einer Anwendung in eine DLL übertragen. Siehe DLL-Entwicklung

Nach dem Setzen von Connected auf True für die DLL-Verbindung, nutzen beide Verbindungen dieselbe physische DBMS-Verbindung. Diese Verbindung muss nach allen Verbindungen geschlossen werden, die dasselbe CLI-Handle teilen.

Beispiel

//Application code (without checks):
FhDll := LoadLibrary(PChar('Project2.dll'));
@FpShowData := GetProcAddress(FhDll, PChar('ShowData'));
FpShowData(FDConnection1.CliHandle);

//DLL code:
procedure ShowData(ACliHandle: LongWord);
begin
  FDConnection1.SharedCliHandle := ACliHandle;
  FDConnection1.Connected := True;
  FDQuery1.Active := True;
end;

Siehe auch