FireDAC.Comp.Client.TFDCustomConnection.CliHandle
Delphi
property CliHandle: Pointer read GetCliHandle;
C++
__property void * CliHandle = {read=GetCliHandle};
Contents
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| property | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomConnection |
Description
CLI handle for connection sharing.
The CliHandle property returns a DBMS Call Level Interface connection handle. This value can be assigned to another SharedCliHandle property of an TFDCustomConnection object. This is useful to transfer a connection from an application into a DLL. See DLL Development.
After setting Connected to True for the DLL connection, both connections will share the same physical DBMS connection. This connection must be closed after all other connections that share the same CLI handle.
Example
//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;