Microsoft SDK for Java

IJavaEventMonitorIDInfo2::
DescribeObject

The DescribeObject method of the IJavaEventMonitorIDInfo2 interface is called by a profiler to obtain a description of special objects containing Microsoft VM-dependent fields. These special objects are instances of classes with special properties. A list of objects supported by this function can be obtained through GetSpecialClassProperties. Classes for which special information is available include instances of Java.Lang.Class, Java.Lang.Reflect.Method, Java.Lang.Reflect.Field, Java.Lang.String, and Java.Lang.StringBuffer.

The DescribeObject method is implemented only by the IJavaEventMonitorIDInfo2 and IJavaEventMonitorIDInfo3 interfaces.

Syntax

HRESULT DescribeObject(ObjectID object_id, LPWSTR *pdescr);

Return Value

A string describing the special object. For example, for an instance of java.lang.Class, the Microsoft VM returns the associated Java class's name. For an instance of java.lang.reflect.Method, the Microsoft VM returns the class name, method name, and signature (parameters and return value) for the associated method.

Parameters

[in] object_id The ObjectID of the class instance that the profiler is interested in.
[out] *pdescr A string that describes the special object.

Remarks

The DescribeObject method works on any class with JVM_CLS_HAS_DESCRIPTION for its JVM_CLASS_PROPERTIES.

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