Microsoft SDK for Java

Implementing Event Notification Interfaces

The profiler must implement a COM object for the profiler event notification mechanism. When events occur for which the profiler has indicated it wants to be notified, COM interface methods implemented by the profiler are called by the Microsoft VM.

The two notification interfaces are IJavaEventMonitor and IJavaEventMonitor2. IJavaEventMonitor is the primary callback interface through which the Microsoft VM communicates with the profiler. For details on these interfaces and their methods, see the Event Notification Profiler Interfaces Reference.

A profiler will normally implement the IJavaEventMonitor2 interface. All these interface methods return S_OK on success and E_FAIL on failure. The Microsoft VM will call QueryInterface on the profiler object's IJavaEventMonitor interface to determine if the IJavaEventMonitor2 interface is supported. If IJavaEventMonitor2 is supported by the profiler, the Microsoft VM will call methods on that interface instead of IJavaEventMonitor.

This section contains the following topics:

Profiler UniqueIDs discusses the handles used by the Microsoft VM to refer to classes, methods, fields, instances, threads, and so on.

Event Types Used for Notification discusses the enumerated event types that determine UniqueIDs.

Retrieving Static Class Information gives an overview of those methods that allow a profiler to retrieve static information about active Java processes.

Retrieving Dynamic Information with the Profiler gives an overview of those methods that allow a profiler to dynamic static information about active Java processes.

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