OnBreakPointReturn

The OnBreakPointReturn event will be called when an api which has be monitored exit.

void OnBreakPointReturn(
  BSTR pszDll,        // The api's dll module name.
  BSTR pszName,       // The api's function name.
  int nParam,         // The number of api's parameter.
  LONG* pParam,       // The array of api's parameters data.
  LONG dwProcessId,   // The debuggee process's ID.
  LONG rc             // The api's return value.
);

Parameters

pszDll

The api's dll module name.

pszName

The api's function name.

nParam

The number of api's parameter (not real api's parameter).

pParam

The array of api's parameters data, the array size is nParam.

dwProcessId

The debuggee process's ID.

rc

The api's return value.

Return Values

No return value.

Examples

VBscript Example:

sub main
  addMenuItem "Save Log", "SaveLogFile"
  addMenuItem "Kill Trace Process", "KillTraceProcess"
  startProcess "Notepad.exe", "c:\a.txt"
end sub

sub SaveLogFile
    MsgBox "Call Save Log File"
    saveLog "c:\aaa.dsf"
end sub

sub KillTraceProcess
    MsgBox "Call Kill Process"
    killProcess false
end sub

sub OnBreakPointReturn(pszDll, pszName, nParam, pParam, dwProcessId, rc)
   echo pszDll & "  " & pszName &"  " & nParam & "  " & dwProcessId & "  " & rc
end sub

JavaScript Example:

function main(){
  addMenuItem("Save Log", "SaveLogFile");
  addMenuItem("Kill Trace Process", "KillTraceProcess");

  startProcess("Notepad.exe", "c:\a.txt");
}

function SaveLogFile(){
    echo("Call Save Log File");
    saveLog("c:\aaa.dsf");
}

function KillTraceProcess(){
    echo("Call Kill Process");
    killProcess(false);
}

function OnBreakPointReturn(pszDll, pszName, nParam, pParam, dwProcessId, rc)
{
   echo (pszDll + "  " + pszName +"  " + nParam + "  " + dwProcessId + "  " + rc);
}

Requirements

Auto Debug for Windows: Unsupport.
Auto Debug Professional: Requires version 5.0 or later.

See Also

Script Information Overview, Script Events, OnBreakPointEntry,OnException ,OnProcessEnd