function ibec_Exec(CommandLine : string; Options : string; CallbackBlock : string) : variant;
The ibec_Exec function runs the specified application.
| CommandLine | The command line (filename plus optional parameters) for the application to be executed. |
| Options | String containing additional options delimited with semicolon; possible options are: |
| OutFile=<file_name> | Name of the file where the output of the application will be stored. |
| ConvertToANSI | If specified, the output will be translated from the OEM-defined character set into an ANSI string. |
| CallbackBlock | A callback IBEBlock which will be executed for each output line. The callback IBEBlock must have at least one input parameter, which will be used to pass an output line within it. If there is no callback block use NULL or an empty string as a value of this parameter. |
| NoWait | If specified, the callback block and the OutFile option will be ignored. ibec_Exec with the NoWait option just starts the process and returns immediately. |
| ShowWindow/HideWindow | By default the ibec_Exec function creates the process with a hidden window, if the NoWait option is not specified. Use the ShowWindow option if you don't need to hide the process window. |
The following example uses the ibec_Exec function to restore a database from a backup copy using GBAK.EXE:
execute ibeblock
as
begin
cbb = 'execute ibeblock (LogStr variant)
as
begin
ibec_Progress(LogStr);
end';
res = ibec_Exec('C:\Program Files\Firebird\Bin\gbak.exe
-r -v -rep -user SYSDBA -pas masterkey
E:\test_db.fbk E:\test_db.fdb',
'OutFile=E:\Restore.log; ConvertToANSI', cbb);
if (res = 0) then
ibec_ShowMessage('Restore process completed successfully');
else
ibec_ShowMessage('Restore process failed with exit code = '||res);
end