FireDAC.Comp.Client.TFDCustomConnection.CliHandle

提供:RAD Studio API Documentation

Delphi

property CliHandle: Pointer read GetCliHandle;

C++

__property void * CliHandle = {read=GetCliHandle};

プロパティ

種類 可視性 ソース ユニット 親
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomConnection


説明

接続共有のための CLI ハンドル。

CliHandle プロパティは、DBMS Call Level Interface 接続ハンドルを返します。この値は、TFDCustomConnection オブジェクトの別の SharedCliHandle プロパティに割り当てることができます。これは、アプリケーションから DDL へ接続を転送する際に便利です。「DLL の開発」を参照してください。 

DDL 接続の Connected を True に設定すると、2 つの接続は、同じ物理 DBMS 接続を共有します。この接続は、その同じ CLI ハンドルを共有するその他すべての接続の後に、閉じなければなりません。

例:

//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;

関連項目