ViewVC Help

View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing

root/public/ibx/branches/journaling/fbintf/IB.pas

Comparing ibx/trunk/fbintf/IB.pas (file contents):
Revision 45 by tony, Tue Dec 6 10:33:46 2016 UTC vs.
Revision 309 by tony, Tue Jul 21 08:00:42 2020 UTC

#	Line 60 | Line 60
60		{                                                                        }
61		{************************************************************************}
62		unit IB;
63	+	{$IFDEF MSWINDOWS}
64	+	{$DEFINE WINDOWS}
65	+	{$ENDIF}
66
67		{$IFDEF FPC}
68	<	{$mode objfpc}{$H+}
68	>	{$mode delphi}
69		{$codepage UTF8}
70		{$interfaces COM}
71	<	{$IF FPC_FULLVERSION < 30000 }
71	>	{$IF defined(FPC) and (FPC_FULLVERSION < 30000) }
72		{$ERROR FPC Version 3.0.0 or later is required}
73	<	{$ENDIF}
73	>	{$IFEND}
74		{$ENDIF}
75
76	+	{$IFNDEF LEGACYFIREBIRDAPIONLY}
77		{$DEFINE USEFIREBIRD3API}
78	+	{$ENDIF}
79	+	{$IFNDEF FIREBIRD3APIONLY}
80		{$DEFINE USELEGACYFIREBIRDAPI}
81	+	{$ENDIF}
82
83		{
84		This unit defines the interfaces used to provide the Pascal Language
#	Line 103 | Line 110 | unit IB;
110
111		5. Straightforward progammatic access to the Firebird API from Pascal programs.
112
113	+	6. FPC and Delphi Support.
114	+
115		String Types
116		============
117
#	Line 117 | Line 126 | unit IB;
126		interface
127
128		uses
129	<	Classes, SysUtils, DB, FBMessages, IBExternals;
129	>	Classes,
130	>	{$IFDEF WINDOWS}Windows, {$ENDIF}
131	>	{$IFDEF FPC} Dynlibs, {$ENDIF}
132	>	SysUtils, DB, FBMessages, IBExternals;
133	>
134	>	const
135	>	{Interface version information}
136	>	FBIntf_Major = 1;
137	>	FBIntf_Minor = 1;
138	>	FBIntf_Release = 6;
139	>	FBIntf_Version = '1.1.6';
140
141		{These include files are converted from the 'C' originals in the Firebird API
142		and define the various constants used by the API}
143
144	<	{$I consts_pub.inc}
145	<	{$I inf_pub.inc}
146	<	{$I configkeys.inc}
144	>	{$I 'include/consts_pub.inc'}
145	>	{$I 'include/inf_pub.inc'}
146	>	{$I 'include/configkeys.inc'}
147
148		{The following constants define the values return by calls to the GetSQLType
149		methods provided by several of the interfaces defined below.}
#	Line 160 | Line 179 | type
179		PGDS__QUAD           = ^TGDS__QUAD;
180		PISC_QUAD            = ^TISC_QUAD;
181
182	+	{$IFNDEF FPC}
183	+	{Delphi missing definitions}
184	+	type
185	+	TLibHandle = THandle;
186	+
187	+	const
188	+	NilHandle = 0;
189	+	DirectorySeparator = '\';
190	+
191	+	{Delphi only seems to define CP_UTF8 and CP_UTF16}
192	+	const
193	+	CP_ACP     = 0;     // default to ANSI code page
194	+	CP_OEMCP   = 1;     // default to OEM (console) code page
195	+	CP_UTF16BE = 1201;  // unicodeFFFE
196	+	CP_UTF7    = 65000; // utf-7
197	+	CP_ASCII   = 20127; // us-ascii
198	+	CP_NONE    = $FFFF; // rawbytestring encoding
199	+
200	+	{$ENDIF}
201	+
202	+	type
203	+	{$IF not declared(TSystemCodePage)}
204	+	TSystemCodePage = word; {not defined in Delphi}
205	+	{$IFEND}
206	+
207		TIBSQLStatementTypes =
208		(SQLUnknown, SQLSelect, SQLInsert,
209		SQLUpdate, SQLDelete, SQLDDL,
210		SQLGetSegment, SQLPutSegment,
211		SQLExecProcedure, SQLStartTransaction,
212		SQLCommit, SQLRollback,
213	<	SQLSelectForUpdate, SQLSetGenerator);
213	>	SQLSelectForUpdate, SQLSetGenerator,
214	>	SQLSavePoint);
215
216		TFBStatusCode = cardinal;
217		TByteArray = array of byte;
218
219	+	IFirebirdAPI = interface;
220		IAttachment = interface;
221		ITransaction = interface;
222	+	IStatement = interface;
223
224	<	{The IParameterBlock generic interface provides the template for all parameter
224	>	{The IParameterBlock interface provides the template for all parameter
225		block interfaces}
226
227	<	generic IParameterBlock<_IItem> = interface
227	>	IParameterBlock<_IItem> = interface
228		function getCount: integer;
229		function Add(ParamType: byte): _IItem;
230		function getItems(index: integer): _IItem;
#	Line 191 | Line 238 | type
238		different parameter block items }
239
240		IParameterBlockItem = interface
241	+	['{53b23f7b-abda-46a5-9aa5-07bd5e723266}']
242		function getParamType: byte;
243		function getAsInteger: integer;
244	<	function getAsString: string;
244	>	function getAsString: AnsiString;
245		function getAsByte: byte;
246	<	procedure setAsString(aValue: string);
246	>	procedure setAsString(aValue: AnsiString);
247		procedure setAsByte(aValue: byte);
248		procedure SetAsInteger(aValue: integer);
249	<	property AsString: string read getAsString write setAsString;
249	>	property AsString: AnsiString read getAsString write setAsString;
250		property AsByte: byte read getAsByte write setAsByte;
251		property AsInteger: integer read getAsInteger write SetAsInteger;
252		end;
#	Line 211 | Line 259 | type
259		This interface can be accessed from IFirebirdAPI.
260		}
261
262	+	TIBDataBaseErrorMessage    = (ShowSQLCode,
263	+	ShowIBMessage,
264	+	ShowSQLMessage);
265	+
266	+	TIBDataBaseErrorMessages   = set of TIBDataBaseErrorMessage;
267	+
268		IStatus = interface
269	+	['{34167722-af38-4831-b08a-93162d58ede3}']
270		function GetIBErrorCode: Long;
271		function Getsqlcode: Long;
272	<	function GetMessage: string;
272	>	function GetMessage: AnsiString;
273		function CheckStatusVector(ErrorCodes: array of TFBStatusCode): Boolean;
274		function GetIBDataBaseErrorMessages: TIBDataBaseErrorMessages;
275		procedure SetIBDataBaseErrorMessages(Value: TIBDataBaseErrorMessages);
#	Line 231 | Line 286 | type
286		TArrayBounds = array of TArrayBound;
287
288		IArrayMetaData = interface
289	+	['{7dd0aea4-59af-4c2a-b958-565d5025c489}']
290		function GetSQLType: cardinal;
291	<	function GetSQLTypeName: string;
291	>	function GetSQLTypeName: AnsiString;
292		function GetScale: integer;
293		function GetSize: cardinal;
294	+	function GetCharSetWidth: integer;
295		function GetCharSetID: cardinal;
296	<	function GetTableName: string;
297	<	function GetColumnName: string;
296	>	function GetTableName: AnsiString;
297	>	function GetColumnName: AnsiString;
298		function GetDimensions: integer;
299		function GetBounds: TArrayBounds;
300		end;
#	Line 262 | Line 319 | type
319		TArrayEventHandler = procedure(Sender: IArray; Reason: TArrayEventReason) of object;
320
321		IArray = interface(IArrayMetaData)
322	+	['{631c6bb1-fb49-44fb-a64a-c49859632b88}']
323		function GetArrayID: TISC_QUAD;
324		procedure Clear;
325		function IsEmpty: boolean;
#	Line 277 | Line 335 | type
335		function GetAsFloat(index: array of integer): Float;
336		function GetAsLong(index: array of integer): Long;
337		function GetAsShort(index: array of integer): Short;
338	<	function GetAsString(index: array of integer): String;
338	>	function GetAsString(index: array of integer): AnsiString;
339		function GetAsVariant(index: array of integer): Variant;
340		procedure SetAsInteger(index: array of integer; AValue: integer);
341		procedure SetAsBoolean(index: array of integer; AValue: boolean);
#	Line 290 | Line 348 | type
348		procedure SetAsDouble(index: array of integer; Value: Double);
349		procedure SetAsFloat(index: array of integer; Value: Float);
350		procedure SetAsShort(index: array of integer; Value: Short);
351	<	procedure SetAsString(index: array of integer; Value: String);
351	>	procedure SetAsString(index: array of integer; Value: AnsiString);
352		procedure SetAsVariant(index: array of integer; Value: Variant);
353		procedure SetBounds(dim, UpperBound, LowerBound: integer);
354		function GetAttachment: IAttachment;
#	Line 304 | Line 362 | type
362		}
363
364		IBlobMetaData = interface
365	+	['{575f3c61-bb33-46a5-8975-bb7d1b6e37cc}']
366		function GetSubType: integer;
367		function GetCharSetID: cardinal;
368		function GetCodePage: TSystemCodePage;
369		function GetSegmentSize: cardinal;
370	<	function GetRelationName: string;
371	<	function GetColumnName: string;
370	>	function GetRelationName: AnsiString;
371	>	function GetColumnName: AnsiString;
372		end;
373
374		{The Blob Parameter block is used to select a Blob Filter}
375
376	<	IBPBItem = interface (IParameterBlockItem) end;
376	>	IBPBItem = interface (IParameterBlockItem)
377	>	['{660822a5-3114-4c16-b6cb-c1a7b2aba70d}']
378	>	end;
379
380	<	IBPB = specialize IParameterBlock<IBPBItem>;
380	>	IBPB = interface (IParameterBlock<IBPBItem>)
381	>	['{e0cb9eb5-17f7-4416-b7d1-3cddd1dfca76}']
382	>	end;
383
384		{ The Blob Interface provides access to a blob data item.
385
#	Line 330 | Line 393 | type
393		TBlobType = (btSegmented,btStream);
394
395		IBlob = interface(IBlobMetaData)
396	+	['{3090a145-7780-442b-b15b-efd4568b8611}']
397		function GetBPB: IBPB;
398		procedure Cancel;
399		procedure Close;
#	Line 340 | Line 404 | type
404		TotalSize: Int64; var BlobType: TBlobType);
405		function Read(var Buffer; Count: Longint): Longint;
406		function Write(const Buffer; Count: Longint): Longint;
407	<	function LoadFromFile(Filename: string): IBlob;
407	>	function LoadFromFile(Filename: AnsiString): IBlob;
408		function LoadFromStream(S: TStream) : IBlob;
409	<	function SaveToFile(Filename: string): IBlob;
409	>	function SaveToFile(Filename: AnsiString): IBlob;
410		function SaveToStream(S: TStream): IBlob;
411		function GetAsString: rawbytestring;
412		procedure SetAsString(aValue: rawbytestring);
#	Line 356 | Line 420 | type
420		the output of an SQL Statement.
421		}
422
423	+	TIBDateTimeFormats = (dfTimestamp, {SQL TIMESTAMP}
424	+	dfDateTime,   {SQL DATETIME}
425	+	dfTime);      {SQL TIME}
426	+
427		{ IColumnMetaData }
428
429		IColumnMetaData = interface
430	+	['{c222e6c3-53c1-469f-9e05-0a5c3ef232d8}']
431		function GetIndex: integer;
432		function GetSQLType: cardinal;
433	<	function GetSQLTypeName: string;
433	>	function GetSQLTypeName: AnsiString;
434		function getSubtype: integer;
435	<	function getRelationName: string;
436	<	function getOwnerName: string;
437	<	function getSQLName: string;    {Name of the column}
438	<	function getAliasName: string;  {Alias Name of column or Column Name if no alias}
439	<	function getName: string;       {Disambiguated uppercase Field Name}
435	>	function getRelationName: AnsiString;
436	>	function getOwnerName: AnsiString;
437	>	function getSQLName: AnsiString;    {Name of the column}
438	>	function getAliasName: AnsiString;  {Alias Name of column or Column Name if no alias}
439	>	function getName: AnsiString;       {Disambiguated uppercase Field Name}
440		function getScale: integer;
441		function getCharSetID: cardinal;
442		function getCodePage: TSystemCodePage;
#	Line 375 | Line 444 | type
444		function GetSize: cardinal;
445		function GetArrayMetaData: IArrayMetaData; {Valid only for Array SQL Type}
446		function GetBlobMetaData: IBlobMetaData; {Valid only for Blob SQL Type}
447	<	property Name: string read GetName;
447	>	function GetDateTimeStrLength(DateTimeFormat: TIBDateTimeFormats): integer;
448	>	function GetStatement: IStatement;
449	>	function GetTransaction: ITransaction;
450	>	property Name: AnsiString read GetName;
451		property Size: cardinal read GetSize;
452		property SQLType: cardinal read GetSQLType;
453		property Scale: integer read getScale;
#	Line 391 | Line 463 | type
463		{ IMetaData }
464
465		IMetaData = interface
466	+	['{4dafdbb6-0d36-4f1f-9c95-8b132804b965}']
467		function getCount: integer;
468		function getColumnMetaData(index: integer): IColumnMetaData;
469	<	function GetUniqueRelationName: string; {Non empty if all columns come from the same table}
470	<	function ByName(Idx: String): IColumnMetaData;
469	>	function GetUniqueRelationName: AnsiString; {Non empty if all columns come from the same table}
470	>	function ByName(Idx: AnsiString): IColumnMetaData;
471		property ColMetaData[index: integer]: IColumnMetaData read getColumnMetaData; default;
472		property Count: integer read getCount;
473		end;
#	Line 414 | Line 487 | type
487
488
489		ISQLData = interface(IColumnMetaData)
490	+	['{3f493e31-7e3f-4606-a07c-b210b9e3619d}']
491	+	function GetStrDataLength: short;
492		function GetAsBoolean: boolean;
493		function GetAsCurrency: Currency;
494		function GetAsInt64: Int64;
#	Line 424 | Line 499 | type
499		function GetAsPointer: Pointer;
500		function GetAsQuad: TISC_QUAD;
501		function GetAsShort: short;
502	<	function GetAsString: String;
502	>	function GetAsString: AnsiString;
503		function GetIsNull: Boolean;
504		function GetAsVariant: Variant;
505		function GetAsBlob: IBlob; overload;
#	Line 443 | Line 518 | type
518		property AsPointer: Pointer read GetAsPointer;
519		property AsQuad: TISC_QUAD read GetAsQuad;
520		property AsShort: short read GetAsShort;
521	<	property AsString: String read GetAsString;
521	>	property AsString: AnsiString read GetAsString;
522		property AsVariant: Variant read GetAsVariant ;
523		property AsBlob: IBlob read GetAsBlob;
524		property AsArray: IArray read GetAsArray;
#	Line 458 | Line 533 | type
533		}
534
535		IResults = interface
536	+	['{e836b2bb-93d1-4bbf-a8eb-7ce535de3bb5}']
537		function getCount: integer;
538	+	function GetStatement: IStatement;
539		function GetTransaction: ITransaction;
540	<	function ByName(Idx: String): ISQLData;
540	>	function ByName(Idx: AnsiString): ISQLData;
541		function getSQLData(index: integer): ISQLData;
542	<	procedure GetData(index: integer; var IsNull:boolean; var len: short; var data: PChar);
542	>	procedure GetData(index: integer; var IsNull:boolean; var len: short; var data: PByte);
543		procedure SetRetainInterfaces(aValue: boolean);
544		property Data[index: integer]: ISQLData read getSQLData; default;
545		property Count: integer read getCount;
#	Line 474 | Line 551 | type
551		in turn, used to access the data returned by each field of the current row.
552		}
553		IResultSet = interface(IResults)
554	+	['{0ae4979b-7857-4e8c-8918-ec6f155b51a0}']
555		function FetchNext: boolean;
556	<	function GetCursorName: string;
556	>	function GetCursorName: AnsiString;
557		function IsEof: boolean;
558		procedure Close;
559		end;
#	Line 496 | Line 574 | type
574		}
575
576		ISQLParam = interface
577	+	['{b22b4578-6d41-4807-a9a9-d2ec8d1d5a14}']
578		function GetIndex: integer;
579		function GetSQLType: cardinal;
580	<	function GetSQLTypeName: string;
580	>	function GetSQLTypeName: AnsiString;
581		function getSubtype: integer;
582	<	function getName: string;
582	>	function getName: AnsiString;
583		function getScale: integer;
584		function getCharSetID: cardinal;
585		function getCodePage: TSystemCodePage;
#	Line 516 | Line 595 | type
595		function GetAsPointer: Pointer;
596		function GetAsQuad: TISC_QUAD;
597		function GetAsShort: short;
598	<	function GetAsString: String;
598	>	function GetAsString: AnsiString;
599		function GetIsNull: boolean;
600		function GetAsVariant: Variant;
601		function GetAsBlob: IBlob;
#	Line 534 | Line 613 | type
613		procedure SetAsFloat(aValue: Float);
614		procedure SetAsPointer(aValue: Pointer);
615		procedure SetAsShort(aValue: Short);
616	<	procedure SetAsString(aValue: String);
616	>	procedure SetAsString(aValue: AnsiString);
617		procedure SetAsVariant(aValue: Variant);
618		procedure SetIsNull(aValue: Boolean);
619		procedure SetAsBlob(aValue: IBlob);
#	Line 553 | Line 632 | type
632		property AsLong: Long read GetAsLong write SetAsLong;
633		property AsPointer: Pointer read GetAsPointer write SetAsPointer;
634		property AsShort: Short read GetAsShort write SetAsShort;
635	<	property AsString: String read GetAsString write SetAsString;
635	>	property AsString: AnsiString read GetAsString write SetAsString;
636		property AsVariant: Variant read GetAsVariant write SetAsVariant;
637		property AsBlob: IBlob read GetAsBlob write SetAsBlob;
638		property AsArray: IArray read GetAsArray write SetAsArray;
#	Line 562 | Line 641 | type
641		property IsNull: Boolean read GetIsNull write SetIsNull;
642		property IsNullable: Boolean read GetIsNullable;
643		property Modified: Boolean read getModified;
644	<	property Name: string read GetName;
644	>	property Name: AnsiString read GetName;
645		property SQLType: cardinal read GetSQLType;
646		end;
647
#	Line 572 | Line 651 | type
651		}
652
653		ISQLParams = interface
654	+	['{c6d95ac7-b2b7-461b-b890-afef0acbb077}']
655		function getCount: integer;
656		function getSQLParam(index: integer): ISQLParam;
657	<	function ByName(Idx: String): ISQLParam ;
657	>	function ByName(Idx: AnsiString): ISQLParam ;
658		function GetModified: Boolean;
659	+	function GetHasCaseSensitiveParams: Boolean;
660		property Modified: Boolean read GetModified;
661		property Params[index: integer]: ISQLParam read getSQLParam; default;
662		property Count: integer read getCount;
663		end;
664
665	+
666	+	TPerfStats = (psCurrentMemory, psMaxMemory,
667	+	psRealTime, psUserTime, psBuffers,
668	+	psReads, psWrites, psFetches,psDeltaMemory);
669	+
670	+	TPerfCounters = array[TPerfStats] of Int64;
671	+
672		{The IStatement interface provides access to an SQL Statement once it has been
673		initially prepared. The interface is returned from the IAttachment interface.
674		}
675
676		IStatement = interface
677	+	['{a260576d-a07d-4a66-b02d-1b72543fd7cf}']
678		function GetMetaData: IMetaData;  {Output Metadata}
679		function GetSQLParams: ISQLParams;{Statement Parameters}
680	<	function GetPlan: String;
680	>	function GetPlan: AnsiString;
681		function GetRowsAffected(var SelectCount, InsertCount, UpdateCount, DeleteCount: integer): boolean;
682		function GetSQLStatementType: TIBSQLStatementTypes;
683	<	function GetSQLText: string;
683	>	function GetSQLText: AnsiString;
684	>	function GetProcessedSQLText: AnsiString;
685		function GetSQLDialect: integer;
686		function IsPrepared: boolean;
687		procedure Prepare(aTransaction: ITransaction=nil);
#	Line 600 | Line 690 | type
690		function GetAttachment: IAttachment;
691		function GetTransaction: ITransaction;
692		procedure SetRetainInterfaces(aValue: boolean);
693	+	procedure EnableStatistics(aValue: boolean);
694	+	function GetPerfStatistics(var stats: TPerfCounters): boolean;
695		property MetaData: IMetaData read GetMetaData;
696		property SQLParams: ISQLParams read GetSQLParams;
697		property SQLStatementType: TIBSQLStatementTypes read GetSQLStatementType;
#	Line 616 | Line 708 | type
708		found in the Interbase 6.0 API Guide.
709		}
710
711	<	ITPBItem = interface(IParameterBlockItem) end;
711	>	ITPBItem = interface(IParameterBlockItem)
712	>	['{544c1f2b-7c12-4a87-a4a5-face7ea72671}']
713	>	end;
714
715	<	ITPB = specialize IParameterBlock<ITPBItem>;
715	>	ITPB = interface(IParameterBlock<ITPBItem>)
716	>	['{7369b0ff-defe-437b-81fe-19b211d42d25}']
717	>	end;
718
719		{The ITransactionAction interface provides access to a Transaction once it
720		has been initially started. After a Commit or Rollback, a transaction
#	Line 632 | Line 728 | type
728		TTransactionCompletion = TARollback.. TACommit;
729
730		ITransaction = interface
731	+	['{30928d0e-a9d7-4c61-b7cf-14f4f38abe2a}']
732		function getTPB: ITPB;
733		procedure Start(DefaultCompletion: TTransactionCompletion=taCommit);
734		function GetInTransaction: boolean;
#	Line 659 | Line 756 | type
756		}
757
758		TEventInfo = record
759	<	EventName: string;
759	>	EventName: AnsiString;
760		Count: integer;
761		end;
762
#	Line 670 | Line 767 | type
767		{ IEvents }
768
769		IEvents = interface
770	+	['{6a0be233-ed08-4524-889c-2e45d0c20e5f}']
771		procedure GetEvents(EventNames: TStrings);
772		procedure SetEvents(EventNames: TStrings); overload;
773	<	procedure SetEvents(EventName: string); overload;
773	>	procedure SetEvents(EventName: AnsiString); overload;
774		procedure Cancel;
775		function ExtractEventCounts: TEventCounts;
776		procedure WaitForEvent;
#	Line 703 | Line 801 | type
801		TDBOperationCounts = array of TDBOperationCount;
802
803		IDBInfoItem = interface
804	+	['{eeb97b51-ec0f-473f-9f75-c1721f055fcb}']
805		function getItemType: byte;
806		function getSize: integer;
807		procedure getRawBytes(var Buffer);
808	<	function getAsString: string;
808	>	function getAsString: AnsiString;
809		function getAsInteger: integer;
810	<	procedure DecodeIDCluster(var ConnectionType: integer; var DBFileName, DBSiteName: string);
810	>	procedure DecodeIDCluster(var ConnectionType: integer; var DBFileName, DBSiteName: AnsiString);
811		function getAsBytes: TByteArray;
812	<	procedure DecodeVersionString(var Version: byte; var VersionString: string);
812	>	function getAsDateTime: TDateTime;
813	>	procedure DecodeVersionString(var Version: byte; var VersionString: AnsiString);
814		function getOperationCounts: TDBOperationCounts;
815		procedure DecodeUserNames(UserNames: TStrings);
816
#	Line 719 | Line 819 | type
819		function GetItem(index: integer): IDBInfoItem;
820		function Find(ItemType: byte): IDBInfoItem;
821		property AsInteger: integer read getAsInteger;
822	<	property AsString: string read GetAsString;
822	>	property AsString: AnsiString read GetAsString;
823		property Count: integer read GetCount;
824		property Items[index: integer]: IDBInfoItem read getItem; default;
825		end;
#	Line 727 | Line 827 | type
827		{ IDBInformation }
828
829		IDBInformation = interface
830	+	['{7ac6777f-f0a9-498a-9f5c-4a57a554df81}']
831		function GetCount: integer;
832		function GetItem(index: integer): IDBInfoItem;
833		function Find(ItemType: byte): IDBInfoItem;
#	Line 735 | Line 836 | type
836		property Items[index: integer]: IDBInfoItem read getItem; default;
837		end;
838
839	+	{The Database Information Request Block is used to pass requests for
840	+	database information where at least one item requested has a parameter.
841	+	At present, this is only fb_info_page_contents which has a single
842	+	integer parameter.}
843	+
844	+	IDIRBItem = interface(IParameterBlockItem)
845	+	['{d34a7511-8435-4a24-81a7-5103d218d234}']
846	+	end;
847	+
848	+	IDIRB = interface(IParameterBlock<IDIRBItem>)
849	+	['{1010e5ac-0a8f-403b-a302-91625e9d9579}']
850	+	end;
851	+
852	+
853		{The Database Parameter Block (DPB).
854
855		The DPB provides the parameters used when connecting to a database. It is allocated
#	Line 746 | Line 861 | type
861		found in the Interbase 6.0 API Guide.
862		}
863
864	<	IDPBItem = interface(IParameterBlockItem) end;
864	>	IDPBItem = interface(IParameterBlockItem)
865	>	['{123d4ad0-087a-4cd1-a344-1b3d03b30673}']
866	>	end;
867
868	<	IDPB = specialize IParameterBlock<IDPBItem>;
868	>	IDPB = interface(IParameterBlock<IDPBItem>)
869	>	['{e676067b-1cf4-4eba-9256-9724f57e0d16}']
870	>	end;
871
872		{The IAttachment interface provides access to a Database Connection. It may be
873		used to:
#	Line 778 | Line 897 | type
897		{ IAttachment }
898
899		IAttachment = interface
900	+	['{466e9b67-9def-4807-b3e7-e08a35e7185c}']
901	+	function getFirebirdAPI: IFirebirdAPI;
902		function getDPB: IDPB;
903		function AllocateBPB: IBPB;
904	+	function AllocateDIRB: IDIRB;
905		procedure Connect;
906		procedure Disconnect(Force: boolean=false);
907		function IsConnected: boolean;
908		procedure DropDatabase;
909		function StartTransaction(TPB: array of byte; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
910		function StartTransaction(TPB: ITPB; DefaultCompletion: TTransactionCompletion=taCommit): ITransaction; overload;
911	<	procedure ExecImmediate(transaction: ITransaction; sql: string; SQLDialect: integer); overload;
912	<	procedure ExecImmediate(TPB: array of byte; sql: string; SQLDialect: integer); overload;
913	<	procedure ExecImmediate(transaction: ITransaction; sql: string); overload;
914	<	procedure ExecImmediate(TPB: array of byte; sql: string); overload;
915	<	function ExecuteSQL(TPB: array of byte; sql: string; SQLDialect: integer; params: array of const): IResults; overload;
916	<	function ExecuteSQL(transaction: ITransaction; sql: string; SQLDialect: integer; params: array of const): IResults; overload;
917	<	function ExecuteSQL(TPB: array of byte; sql: string; params: array of const): IResults; overload;
918	<	function ExecuteSQL(transaction: ITransaction; sql: string; params: array of const): IResults; overload;
919	<	function OpenCursor(transaction: ITransaction; sql: string; aSQLDialect: integer): IResultSet; overload;
920	<	function OpenCursor(transaction: ITransaction; sql: string; aSQLDialect: integer;
911	>	procedure ExecImmediate(transaction: ITransaction; sql: AnsiString; SQLDialect: integer); overload;
912	>	procedure ExecImmediate(TPB: array of byte; sql: AnsiString; SQLDialect: integer); overload;
913	>	procedure ExecImmediate(transaction: ITransaction; sql: AnsiString); overload;
914	>	procedure ExecImmediate(TPB: array of byte; sql: AnsiString); overload;
915	>	function ExecuteSQL(TPB: array of byte; sql: AnsiString; SQLDialect: integer; params: array of const): IResults; overload;
916	>	function ExecuteSQL(transaction: ITransaction; sql: AnsiString; SQLDialect: integer; params: array of const): IResults; overload;
917	>	function ExecuteSQL(TPB: array of byte; sql: AnsiString; params: array of const): IResults; overload;
918	>	function ExecuteSQL(transaction: ITransaction; sql: AnsiString; params: array of const): IResults; overload;
919	>	function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer): IResultSet; overload;
920	>	function OpenCursor(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
921		params: array of const): IResultSet; overload;
922	<	function OpenCursor(transaction: ITransaction; sql: string): IResultSet; overload;
923	<	function OpenCursor(transaction: ITransaction; sql: string;
922	>	function OpenCursor(transaction: ITransaction; sql: AnsiString): IResultSet; overload;
923	>	function OpenCursor(transaction: ITransaction; sql: AnsiString;
924		params: array of const): IResultSet; overload;
925	<	function OpenCursorAtStart(transaction: ITransaction; sql: string; aSQLDialect: integer): IResultSet; overload;
926	<	function OpenCursorAtStart(transaction: ITransaction; sql: string; aSQLDialect: integer;
925	>	function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer): IResultSet; overload;
926	>	function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer;
927		params: array of const): IResultSet; overload;
928	<	function OpenCursorAtStart(transaction: ITransaction; sql: string): IResultSet; overload;
929	<	function OpenCursorAtStart(transaction: ITransaction; sql: string;
928	>	function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString): IResultSet; overload;
929	>	function OpenCursorAtStart(transaction: ITransaction; sql: AnsiString;
930		params: array of const): IResultSet; overload;
931	<	function OpenCursorAtStart(sql: string): IResultSet; overload;
932	<	function OpenCursorAtStart(sql: string;
931	>	function OpenCursorAtStart(sql: AnsiString): IResultSet; overload;
932	>	function OpenCursorAtStart(sql: AnsiString;
933		params: array of const): IResultSet; overload;
934	<	function Prepare(transaction: ITransaction; sql: string; aSQLDialect: integer): IStatement; overload;
935	<	function Prepare(transaction: ITransaction; sql: string): IStatement; overload;
936	<	function PrepareWithNamedParameters(transaction: ITransaction; sql: string;
937	<	aSQLDialect: integer; GenerateParamNames: boolean=false): IStatement; overload;
938	<	function PrepareWithNamedParameters(transaction: ITransaction; sql: string;
939	<	GenerateParamNames: boolean=false): IStatement; overload;
934	>	function Prepare(transaction: ITransaction; sql: AnsiString; aSQLDialect: integer): IStatement; overload;
935	>	function Prepare(transaction: ITransaction; sql: AnsiString): IStatement; overload;
936	>	function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
937	>	aSQLDialect: integer; GenerateParamNames: boolean=false;
938	>	CaseSensitiveParams: boolean = false): IStatement; overload;
939	>	function PrepareWithNamedParameters(transaction: ITransaction; sql: AnsiString;
940	>	GenerateParamNames: boolean=false;
941	>	CaseSensitiveParams: boolean = false): IStatement; overload;
942
943		{Events}
944		function GetEventHandler(Events: TStrings): IEvents; overload;
945	<	function GetEventHandler(Event: string): IEvents; overload;
945	>	function GetEventHandler(Event: AnsiString): IEvents; overload;
946
947		{Blob - may use to open existing Blobs. However, ISQLData.AsBlob is preferred}
948
949	<	function CreateBlob(transaction: ITransaction; RelationName, ColumnName: string; BPB: IBPB=nil): IBlob; overload;
949	>	function CreateBlob(transaction: ITransaction; RelationName, ColumnName: AnsiString; BPB: IBPB=nil): IBlob; overload;
950		function CreateBlob(transaction: ITransaction; BlobMetaData: IBlobMetaData; BPB: IBPB=nil): IBlob; overload;
951		function CreateBlob(transaction: ITransaction; SubType: integer; CharSetID: cardinal=0; BPB: IBPB=nil): IBlob; overload;
952	<	function OpenBlob(transaction: ITransaction; RelationName, ColumnName: string; BlobID: TISC_QUAD; BPB: IBPB=nil): IBlob;
952	>	function OpenBlob(transaction: ITransaction; RelationName, ColumnName: AnsiString; BlobID: TISC_QUAD; BPB: IBPB=nil): IBlob; overload;
953	>	function OpenBlob(transaction: ITransaction; BlobMetaData: IBlobMetaData; BlobID: TISC_QUAD; BPB: IBPB=nil): IBlob;  overload;
954
955		{Array - may use to open existing arrays. However, ISQLData.AsArray is preferred}
956
957	<	function OpenArray(transaction: ITransaction; RelationName, ColumnName: string; ArrayID: TISC_QUAD): IArray;
958	<	function CreateArray(transaction: ITransaction; RelationName, ColumnName: string): IArray; overload;
957	>	function OpenArray(transaction: ITransaction; RelationName, ColumnName: AnsiString; ArrayID: TISC_QUAD): IArray; overload;
958	>	function OpenArray(transaction: ITransaction; ArrayMetaData: IArrayMetaData; ArrayID: TISC_QUAD): IArray; overload;
959	>	function CreateArray(transaction: ITransaction; RelationName, ColumnName: AnsiString): IArray; overload;
960		function CreateArray(transaction: ITransaction; ArrayMetaData: IArrayMetaData): IArray; overload;
961	+	function CreateArrayMetaData(SQLType: cardinal; tableName: AnsiString; columnName: AnsiString;
962	+	Scale: integer; size: cardinal; charSetID: cardinal; dimensions: cardinal;
963	+	bounds: TArrayBounds): IArrayMetaData;
964
965		{Database Information}
966		function GetSQLDialect: integer;
967	<	function GetBlobMetaData(Transaction: ITransaction; tableName, columnName: string): IBlobMetaData;
968	<	function GetArrayMetaData(Transaction: ITransaction; tableName, columnName: string): IArrayMetaData;
967	>	function GetBlobMetaData(Transaction: ITransaction; tableName, columnName: AnsiString): IBlobMetaData;
968	>	function GetArrayMetaData(Transaction: ITransaction; tableName, columnName: AnsiString): IArrayMetaData;
969		function GetDBInformation(Requests: array of byte): IDBInformation; overload;
970		function GetDBInformation(Request: byte): IDBInformation; overload;
971	+	function GetDBInformation(Requests: IDIRB): IDBInformation; overload;
972	+	function GetConnectString: AnsiString;
973	+	function GetRemoteProtocol: AnsiString;
974	+	function GetAuthenticationMethod: AnsiString;
975	+	function GetSecurityDatabase: AnsiString;
976	+	function GetODSMajorVersion: integer;
977	+	function GetODSMinorVersion: integer;
978	+	procedure getFBVersion(version: TStrings);
979		function HasActivity: boolean;
980	+
981	+	{Character Sets}
982	+	function HasDefaultCharSet: boolean;
983	+	function GetDefaultCharSetID: integer;
984	+	function GetCharsetName(CharSetID: integer): AnsiString;
985	+	function CharSetID2CodePage(CharSetID: integer; var CodePage: TSystemCodePage): boolean;
986	+	function CodePage2CharSetID(CodePage: TSystemCodePage; var CharSetID: integer): boolean;
987	+	function CharSetName2CharSetID(CharSetName: AnsiString; var CharSetID: integer): boolean;
988	+	function CharSetWidth(CharSetID: integer; var Width: integer): boolean;
989	+	procedure RegisterCharSet(CharSetName: AnsiString; CodePage: TSystemCodePage;
990	+	AllowReverseLookup:boolean; out CharSetID: integer);
991		end;
992
993	<	TProtocol = (TCP, SPX, NamedPipe, Local);
993	>	TProtocolAll = (TCP, SPX, NamedPipe, Local, inet, inet4, inet6, wnet, xnet, unknownProtocol);
994	>	TProtocol = TCP..xnet;
995
996		{Service Parameter Block (SPB).
997
#	Line 856 | Line 1005 | type
1005
1006		}
1007
1008	<	ISPBItem = interface(IParameterBlockItem) end;
1008	>	ISPBItem = interface(IParameterBlockItem)
1009	>	['{5d08ae2b-4519-41bd-8b40-97cd451c3f6a}']
1010	>	end;
1011
1012	<	ISPB = specialize IParameterBlock<ISPBItem>;
1012	>	ISPB = interface(IParameterBlock<ISPBItem>)
1013	>	['{2c5836fd-41ed-4426-9b7d-5af580ec2659}']
1014	>	end;
1015
1016		{Service Query Parameter Block (SQPB).
1017
#	Line 867 | Line 1020 | type
1020		}
1021
1022		ISQPBItem = interface(IParameterBlockItem)
1023	+	['{b07841a6-33b3-47f0-b5a2-028cbc86dc97}']
1024		function CopyFrom(source: TStream; count: integer): integer;
1025		end;
1026
1027	<	ISQPB = specialize IParameterBlock<ISQPBItem>;
1027	>	ISQPB = interface(IParameterBlock<ISQPBItem>)
1028	>	['{8553e66b-ee62-498b-8431-dff030211447}']
1029	>	end;
1030
1031		{Service Request Block (SRB).
1032
#	Line 884 | Line 1040 | type
1040
1041		}
1042
1043	<	ISRBItem = interface(IParameterBlockItem) end;
1043	>	ISRBItem = interface(IParameterBlockItem)
1044	>	['{47ec790e-f265-4b30-9dcd-261e51677245}']
1045	>	end;
1046
1047	<	ISRB = specialize IParameterBlock<ISRBItem>;
1047	>	ISRB = interface(IParameterBlock<ISRBItem>)
1048	>	['{9f2e204f-3c33-4e44-90f9-9135e95dafb9}']
1049	>	end;
1050
1051		{The Service Query Results Interface.
1052
#	Line 904 | Line 1064 | type
1064		}
1065
1066		IServiceQueryResultSubItem = interface
1067	+	['{8a4c381e-9923-4cc9-a96b-553729248640}']
1068		function getItemType: byte;
1069		function getSize: integer;
1070		procedure getRawBytes(var Buffer);
1071	<	function getAsString: string;
1071	>	function getAsString: AnsiString;
1072		function getAsInteger: integer;
1073		function getAsByte: byte;
1074		function CopyTo(stream: TStream; count: integer): integer;
1075	<	property AsString: string read getAsString;
1075	>	property AsString: AnsiString read getAsString;
1076		property AsInteger: integer read getAsInteger;
1077		property AsByte: byte read getAsByte;
1078		end;
1079
1080		IServiceQueryResultItem = interface(IServiceQueryResultSubItem)
1081	+	['{b2806886-206c-4024-8df9-5fe0a7630a5e}']
1082		function getCount: integer;
1083		function getItem(index: integer): IServiceQueryResultSubItem;
1084		function find(ItemType: byte): IServiceQueryResultSubItem;
#	Line 925 | Line 1087 | type
1087		end;
1088
1089		IServiceQueryResults = interface
1090	+	['{8fbbef7d-fe03-4409-828a-a787d34ef531}']
1091		function getCount: integer;
1092		function getItem(index: integer): IServiceQueryResultItem;
1093		function find(ItemType: byte): IServiceQueryResultItem;
#	Line 933 | Line 1096 | type
1096		property Count: integer read getCount;
1097		end;
1098
1099	+	IFirebirdLibrary = interface;
1100	+
1101		{The IServiceManager interface provides access to a service manager. It can
1102		used to Detach and re-attach to Service Manager, to start services and to
1103		query the service manager.
#	Line 943 | Line 1108 | type
1108		{ IServiceManager }
1109
1110		IServiceManager = interface
1111	+	['{905b587d-1e1f-4e40-a3f8-a3519f852e48}']
1112	+	function getFirebirdAPI: IFirebirdAPI;
1113		function getSPB: ISPB;
1114	<	function getServerName: string;
1114	>	function getServerName: AnsiString;
1115	>	function getProtocol: TProtocol;
1116	>	function getPortNo: AnsiString;
1117		procedure Attach;
1118		procedure Detach(Force: boolean=false);
1119		function IsAttached: boolean;
1120		function AllocateSRB: ISRB;
1121		function AllocateSQPB: ISQPB;
1122	<	procedure Start(Request: ISRB);
1123	<	function Query(SQPB: ISQPB; Request: ISRB) :IServiceQueryResults; overload;
1124	<	function Query(Request: ISRB) :IServiceQueryResults; overload;
1122	>	function Start(Request: ISRB; RaiseExceptionOnError: boolean=true): boolean;
1123	>	function Query(SQPB: ISQPB; Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
1124	>	function Query(Request: ISRB; RaiseExceptionOnError: boolean=true) :IServiceQueryResults; overload;
1125	>	end;
1126	>
1127	>	{Tbe Firebird Library API used to get information about the Firebird library}
1128	>
1129	>
1130	>	IFirebirdLibrary = interface
1131	>	['{3c04e0a1-12e0-428a-b2e1-bc6fcd97b79b}']
1132	>	function GetHandle: TLibHandle;
1133	>	function GetLibraryName: string;
1134	>	function GetLibraryFilePath: string;
1135	>	function GetFirebirdAPI: IFirebirdAPI;
1136		end;
1137
1138		{The Firebird API.
#	Line 964 | Line 1144 | type
1144		}
1145
1146		IFirebirdAPI = interface
1147	+	['{edeee691-c8d3-4dcf-a780-cd7e432821d5}']
1148		{Database connections}
1149		function AllocateDPB: IDPB;
1150	<	function OpenDatabase(DatabaseName: string; DPB: IDPB; RaiseExceptionOnConnectError: boolean=true): IAttachment;
1151	<	function CreateDatabase(DatabaseName: string; DPB: IDPB; RaiseExceptionOnError: boolean=true): IAttachment;
1150	>	function OpenDatabase(DatabaseName: AnsiString; DPB: IDPB; RaiseExceptionOnConnectError: boolean=true): IAttachment;
1151	>	function CreateDatabase(DatabaseName: AnsiString; DPB: IDPB; RaiseExceptionOnError: boolean=true): IAttachment; overload;
1152	>	function CreateDatabase(sql: AnsiString; aSQLDialect: integer; RaiseExceptionOnError: boolean=true): IAttachment; overload;
1153
1154		{Start Transaction against multiple databases}
1155		function AllocateTPB: ITPB;
#	Line 979 | Line 1161 | type
1161		{Service Manager}
1162		function HasServiceAPI: boolean;
1163		function AllocateSPB: ISPB;
1164	<	function GetServiceManager(ServerName: string; Protocol: TProtocol; SPB: ISPB): IServiceManager;
1164	>	function GetServiceManager(ServerName: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; overload;
1165	>	function GetServiceManager(ServerName: AnsiString; Port: AnsiString; Protocol: TProtocol; SPB: ISPB): IServiceManager; overload;
1166
1167		{Information}
1168		function GetStatus: IStatus;
986	–	function GetLibraryName: string;
1169		function HasRollbackRetaining: boolean;
1170		function IsEmbeddedServer: boolean;
1171	<	function GetImplementationVersion: string;
1171	>	function GetImplementationVersion: AnsiString;
1172	>	function GetClientMajor: integer;
1173	>	function GetClientMinor: integer;
1174
1175		{Firebird 3 API}
1176		function HasMasterIntf: boolean;
1177		function GetIMaster: TObject;
1178	<
995	<	{utility}
996	<	function GetCharsetName(CharSetID: integer): string;
997	<	function CharSetID2CodePage(CharSetID: integer; var CodePage: TSystemCodePage): boolean;
998	<	function CodePage2CharSetID(CodePage: TSystemCodePage; var CharSetID: integer): boolean;
999	<	function CharSetName2CharSetID(CharSetName: string; var CharSetID: integer): boolean;
1000	<	function CharSetWidth(CharSetID: integer; var Width: integer): boolean;
1178	>	function GetFBLibrary: IFirebirdLibrary;
1179		end;
1180
1181		type
#	Line 1014 | Line 1192 | type
1192		private
1193		FSQLCode: Long;
1194		public
1195	<	constructor Create(ASQLCode: Long; Msg: string);
1195	>	constructor Create(ASQLCode: Long; Msg: AnsiString);
1196		property SQLCode: Long read FSQLCode;
1197		end;
1198
#	Line 1025 | Line 1203 | type
1203		FIBErrorCode: Long;
1204		public
1205		constructor Create(Status: IStatus); overload;
1206	<	constructor Create(ASQLCode: Long; AIBErrorCode: Long; Msg: string); overload;
1206	>	constructor Create(ASQLCode: Long; AIBErrorCode: Long; Msg: AnsiString); overload;
1207		property IBErrorCode: Long read FIBErrorCode;
1208		end;
1209
1210		{IB Client Exceptions}
1211		EIBClientError = class(EIBError);
1212
1035	–	{IBError is used internally and by IBX to throw an EIBClientError}
1036	–
1037	–	procedure IBError(ErrMess: TIBClientError; const Args: array of const);
1038	–
1213		{The Firebird API function is used to access the IFirebirdAPI interface.
1214
1215		It will load the Firebird Client Library if this is not already loaded and
#	Line 1050 | Line 1224 | function FirebirdAPI: IFirebirdAPI;
1224		function TryIBLoad: Boolean;
1225		procedure CheckIBLoaded;
1226
1227	+	{If you want to explicitly load the Firebird library from a
1228	+	non-default location then use this function and its GetFirebirdAPI function
1229	+	to get the API.}
1230	+
1231	+	function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary;
1232	+
1233		implementation
1234
1235		uses FBClientAPI
1236		{$IFDEF USELEGACYFIREBIRDAPI}, FB25ClientAPI {$ENDIF}
1237		{$IFDEF USEFIREBIRD3API}, FB30ClientAPI {$ENDIF};
1238
1239	<	var FFirebirdAPI: IFirebirdAPI;
1239	>	var FDefaultFBLibrary: IFirebirdLibrary;
1240	>
1241	>	type
1242	>
1243	>	{ TFBLibrary }
1244	>
1245	>	TFBLibraryImpl = class(TFBLibrary)
1246	>	protected
1247	>	function GetFirebird3API: IFirebirdAPI; override;
1248	>	function GetLegacyFirebirdAPI: IFirebirdAPI; override;
1249	>	end;
1250	>
1251	>	function TFBLibraryImpl.GetFirebird3API: IFirebirdAPI;
1252	>	begin
1253	>	{$IFDEF USEFIREBIRD3API}
1254	>	Result := TFB30ClientAPI.Create(self);
1255	>	{$ELSE}
1256	>	Result := nil;
1257	>	{$ENDIF}
1258	>	end;
1259	>
1260	>	function TFBLibraryImpl.GetLegacyFirebirdAPI: IFirebirdAPI;
1261	>	begin
1262	>	{$IFDEF USELEGACYFIREBIRDAPI}
1263	>	Result := TFB25ClientAPI.Create(self);
1264	>	{$ELSE}
1265	>	Result := nil;
1266	>	{$ENDIF}
1267	>	end;
1268
1269		function FirebirdAPI: IFirebirdAPI;
1270		begin
1271	<	if FFirebirdAPI = nil then
1271	>	if FDefaultFBLibrary = nil then
1272		CheckIBLoaded;
1273	<	Result := FFirebirdAPI;
1273	>	Result := FDefaultFBLibrary.GetFirebirdAPI;
1274		end;
1275
1276		function TryIBLoad: Boolean;
1277	+	var fblib: IFirebirdLibrary;
1278		begin
1279	<	Result := FFirebirdAPI <> nil;
1279	>	Result := FDefaultFBLibrary <> nil;
1280		try
1072	–	{$IFDEF USEFIREBIRD3API}
1281		if not Result then
1282		begin
1283	<	FFirebirdAPI := TFB30ClientAPI.Create;
1284	<	Result := FFirebirdAPI.HasMasterIntf;
1285	<	end;
1286	<	{$ENDIF}
1079	<	{$IFDEF USELEGACYFIREBIRDAPI}
1080	<	if not Result then
1081	<	begin
1082	<	FFirebirdAPI := nil;
1083	<	FFirebirdAPI := TFB25ClientAPI.Create;
1084	<	Result := true;
1085	<	end;
1086	<	{$ENDIF}
1087	<	if Result and not (FFirebirdAPI as TFBClientAPI).IsLibraryLoaded then
1088	<	begin
1089	<	Result := false;
1090	<	FFirebirdAPI := nil;
1283	>	fblib := TFBLibraryImpl.Create;
1284	>	if (fblib <> nil) and (fblib.GetFirebirdAPI <> nil) then
1285	>	FDefaultFBLibrary := fblib;
1286	>	Result := FDefaultFBLibrary <> nil;
1287		end;
1288		except
1289		SysUtils.showexception(ExceptObject,ExceptAddr);
#	Line 1101 | Line 1297 | begin
1297		IBError(ibxeInterBaseMissing, [nil]);
1298		end;
1299
1300	+	function LoadFBLibrary(aLibPathName: string): IFirebirdLibrary;
1301	+	var fblib: IFirebirdLibrary;
1302	+	begin
1303	+	if trim(aLibPathName) = '' then
1304	+	begin
1305	+	CheckIBLoaded;
1306	+	Result := FDefaultFBLibrary;
1307	+	end
1308	+	else
1309	+	begin
1310	+	fblib := TFBLibraryImpl.GetFBLibrary(aLibPathName);
1311	+	if (fblib = nil) or (fblib.GetFirebirdAPI = nil) then
1312	+	IBError(ibxeInterBaseMissing, [nil]);
1313	+	Result := fblib;
1314	+	end;
1315	+	end;
1316	+
1317		{ EIBError }
1318
1319	<	constructor EIBError.Create(ASQLCode: Long; Msg: string);
1319	>	constructor EIBError.Create(ASQLCode: Long; Msg: AnsiString);
1320		begin
1321		inherited Create(Msg);
1322		FSQLCode := ASQLCode;
#	Line 1118 | Line 1331 | begin
1331		end;
1332
1333		constructor EIBInterBaseError.Create(ASQLCode: Long; AIBErrorCode: Long;
1334	<	Msg: string);
1334	>	Msg: AnsiString);
1335		begin
1336		inherited Create(ASQLCode,Msg);
1337		FIBErrorCode := AIBErrorCode;
1338		end;
1339
1127	–	procedure IBError(ErrMess: TIBClientError; const Args: array of const);
1128	–	begin
1129	–	raise EIBClientError.Create(Ord(ErrMess),
1130	–	Format(GetErrorMessage(ErrMess), Args));
1131	–	end;
1340
1341		initialization
1342	<	FFirebirdAPI := nil;
1342	>	FDefaultFBLibrary := nil;
1343
1344	+	finalization
1345	+	FDefaultFBLibrary := nil;
1346
1347		end.
1348

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines