The RequestCreateEvent method of the IRemoteDebugManager interface is called by a debugger to notify the Microsoft VM’s Debug Manager that the debugger is interested in debugging a Java process, optionally specifying a particular Java class.
HRESULT RequestCreateEvent(LPCOLESTR pszProcessName, DWORD dwParentProcessId)
[in] pszProcessName | The name of the Java class to debug, that is, an applet or application. The debugger can request debugging of any Java class by passing in an empty string (""). |
[in] dwParentProcessId | The Win32 process ID of the Java process that the debugger wants to debug. The debugger can request debugging of the next Java process to begin execution by passing in 0xFFFFFFFF. |
S_OK Success.
E_OUTOFMEMORY Insufficient memory.
The RequestCreateEvent method takes two parameters. The debugger can register to receive a notification when the next new Java process is created or when a specific Win32 process starts up the Microsoft VM. The debugger can also register to receive notification when the Microsoft VM in that process starts up, or to delay notification until a specific Java class is loaded in that process. There are four possible combinations of these two parameters. The debugger can pass 0xFFFFFFFF for dwParentProcessID to register to receive notifications for the next Java process that starts up. Any other value for dwParentProcessID indicates a specific Win32 process. The debugger can pass a zero-length string for pcszProcessName to register to receive notification as soon as the Microsoft VM starts up in that process. Any other value for pcszProcessName indicates a specific Java class that the debugger wants to wait for before receiving notification.