Microsoft SDK for Java

IRemoteDebugManager::
RequestCreateEvent

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.

Syntax

HRESULT RequestCreateEvent(LPCOLESTR pszProcessName, DWORD dwParentProcessId)

Parameters

[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.

Return Value

S_OK Success.

E_OUTOFMEMORY Insufficient memory.

Remarks

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.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.