OnBreakPointEntry

The OnBreakPointEntry event will be called when an api which has be monitored entry.

void OnBreakPointEntry(
  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.
);

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.

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 OnBreakPointEntry(pszDll, pszName, nParam, pParam, dwProcessId)
   echo pszDll & "  " & pszName &"  " & nParam & "  " & dwProcessId
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 OnBreakPointEntry(pszDll, pszName, nParam, pParam, dwProcessId)
{
   echo (pszDll + "  " + pszName +"  " + nParam + "  " + dwProcessId);
}

Requirements

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

See Also

Script Information Overview, Script Events, OnBreakPointReturn,OnException ,OnProcessEnd