 |
 |
 |
||
| Java Language Debug Interfaces | Previous | VM |
Dynamic Information Interfaces
Dynamic information on a Java process is available through the IRemoteObject hierarchy of interfaces. These interfaces provide bound access to objects of different types. An object does not necessarily refer to an instance of a class, but represents an instance of any type. The information obtained from an IRemoteObject is only valid during the lifetime of the actual object that it represents. Consequently, dynamic information cannot be cached by the debugger.
Access to dynamic information in a Java process is based on using the IRemoteThreadGroup and IRemoteThread passed on each ThreadGroupCreateEvent and ThreadCreateEvent notification to the debugger. The IRemoteProcess:GetGlobalContainerObject method can also be used to access the root of this object hierarchy and descend down it to retrieve IRemoteClassField objects.
The dynamic information interfaces consist primarily of IRemoteObject, IRemoteObjectEx, IEnumRemoteObject, the IEnumRemoteValue interfaces, and a collection of other interfaces designed for a specific Java object (primitive data types, arrays, or classes) that inherit from IRemoteObject or IEnumRemoteValue.
IRemoteObject : IUnknown
The IremoteObject interface represents bound access to objects of different types in a Java process. An object does not necessarily refer to an instance of a class; it refers to an instance of any type.
The information obtained from an IRemoteObject is valid only during the lifetime of the actual object that it represents.
IRemoteObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The type will be either a class type or a Java native object type (boolean, short, integer, long, and so on.).
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)Remarks
For classes, the value of the object changes when the object references a different instance of that class, not when any of the instance's data members change. For arrays, the object is considered changed when a new array is assigned to this object, not when any of its elements change.
IRemoteObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteObjectEx : IRemoteObject
The IremoteObjectEx interface represents bound access to objects of different types in a Java process. An object does not necessarily refer to an instance of a class; it refers to an instance of any type. This interface inherits from IRemoteObject and adds three new methods.
The information obtained from IRemoteObjectEx is valid only during the lifetime of the actual object that it represents.
IRemoteObjectEx::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The type will be either a class type or a Java native object type (boolean, short, integer, long, and so on).
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns IRemoteField from which the type of this object can be determined. |
IRemoteObjectEx::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)Remarks
For classes, the value of the object changes when the object references a different instance of that class, not when any of the instance's data members change. For arrays, the object is considered changed when a new array is assigned to this object, not when any of its elements change.
IRemoteObjectEx::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteObjectEx::IsSameObject
The IsSameObject method indicates whether two objects are the same object.
HRESULT IsSameObject (IRemoteObject *other)
| Parameter | Description |
| [in] other | The other object to compare with this object. |
Remarks
A return value of S_OK indicates that the two objects are the same object.
IRemoteObjectEx::GetContainer
The GetContainer method returns IRemoteObject that represents the container for the current object. This methods allows a debugger to navigate back up the hierarchy of objects.
HRESULT GetContainer (IRemoteObject **ppContaainer)
| Parameter | Description |
| [out] ppContainer | The object representing the container for the current object. |
IRemoteObjectEx::GetIdentity
The GetIdentity method returns a new IRemoteObjectEx that is detached from its containers. This method is used for data breakpoints and allows a debugger to hang on to an object across execution.
HRESULT GetIdentity (IRemoteObjectEx *pIdentity)
| Parameter | Description |
| [out] pIdentity | A new object representing the current object that is detached from its containers. |
IRemoteBooleanObject : IRemoteObject
The IRemoteBooleanObject represents bound access to a boolean object in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from IRemoteBooleanObject is valid only during the lifetime of the actual object that it represents.
IRemoteBooleanObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for an IRemoteBooleanObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns IRemoteField from which the type of this object can be determined. |
IRemoteBooleanObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteBooleanObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteBooleanObject::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_BOOLEAN *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the boolean value of this object. |
IRemoteBooleanObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_BOOLEAN value)
| Parameter | Description |
| [in] value | The boolean value that this object should be set to. |
IRemoteByteObject : IRemoteObject
The IRemoteByteObject provides run-time access to the value of a byte variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from IRemoteByteObject is valid only during the lifetime of the actual object that it represents.
IRemoteByteObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for IRemoteByteObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns IRemoteField from which the type of this object can be determined. |
IRemoteByteObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteByteObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteByteObject::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_BYTE *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the byte value of this object. |
IRemoteByteObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_BYTE value)
| Parameter | Description |
| [in] value | The byte value that this object should be set to. |
IRemoteCharObject : IRemoteObject
The IRemoteCharObject provides run-time access to the value of a character variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from IRemoteCharObject is valid only during the lifetime of the actual object that it represents.
IRemoteCharObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for IRemoteCharObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns IRemoteField from which the type of this object can be determined. |
IRemoteCharObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteCharObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteCharObject::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_CHAR *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the character value of this object. |
IRemoteCharObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_CHAR value)
| Parameter | Description |
| [in] value | The character value that this object should be set to. |
IRemoteContainerObject : IRemoteObject
The IRemoteContainerObject provides run-time access to the container objects (FILED_KIND_CLASS or FIELD_KIND_METHOD) in a Java process. This interface inherits from IRemoteObject and adds one new method.
The information obtained from IRemoteContainerObject is valid only during the lifetime of the actual object that it represents.
IRemoteContainerObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. IRemoteContainerObject can be any of the FIELD_KINDs.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteContainerObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteContainerObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteContainerObject::GetFieldObject
The GetFieldObject method returns an IRemoteObject that represents the object contained within that IRemoteContainer object. The IRemoteObject object that is returned is bound to its container. IRemoteField can be used to extract the value of that field from many different IRemoteContainerObject instances in the same Java process. This method allows a debugger to navigate down the hierarchy of objects.
HRESULT GetFieldObject (IRemoteField *pField, IRemoteObject **ppFieldObject)
| Parameter | Description |
| [in] pField | The field in the IRemoteContainer object that is requested. |
| [out] ppFieldObject | The field object representing this field in the container. |
Remarks
The GetType method called on the returned IRemoteObject will return the original IRemoteField that was passed to the GetFieldObject method.
IRemoteClassObject : IRemoteContainerObject
The IRemoteClassObject provides run-time access to the container objects in a Java process. This interface inherits from IRemoteContainerObject and adds one new method.
The information obtained from IRemoteClassObject is valid only during the lifetime of the actual object that it represents.
IRemoteClassObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object, FIELD_KIND_DATA_OBJECT for IRemoteClassObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns IRemoteField from which the type of this object can be determined. |
IRemoteClassObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteClassObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteClassObject::GetFieldObject
The GetFieldObject method returns IRemoteObject that represents the object contained in the field of this object. The IRemoteObject object that is returned is not bound to the instance of the object and can be used to extract the value of that field from many different IRemoteClassObject instances in the same Java process. This method allows a debugger to navigate down the hierarchy of objects.
HRESULT GetFieldObject (IRemoteField *pField, IRemoteObject **ppFieldObject)
| Parameter | Description |
| [in] pField | The field in the IRemoteClass object that is requested. |
| [out] ppFieldObject | The field object representing this field in the container. |
Remarks
The GetType method called on the returned IRemoteObject will return the original IRemoteField that was passed to the GetFieldObject method.
IRemoteClassObject::GetDerivedMostType
The GetDerivedMostType method returns an IRemoteClassField that represents the object's derived-most type. An example of a derived-most type would be a MyException class derived from the java.io.IOException class. This method would return the MyException class for the IRemoteClassField.
HRESULT GetDerivedMostType (IRemoteClassField **ppDerivedMostField)
| Parameter | Description |
| [out] ppDerivedMostField | The object’s derived most type. |
IRemoteDoubleObject : IRemoteObject
The IRemoteDoubleObject provides run-time access to the value of a double variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from an IRemoteDoubleObject is valid only during the lifetime of the actual object that it represents.
IRemoteDoubleObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for an IRemoteDoubleObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteDoubleObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteDoubleObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteDouble::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_DOUBLE *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the value of this object. |
IRemoteDoubleObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_DOUBLE value)
| Parameter | Description |
| [in] value | The value that this object should be set to. |
IRemoteFloatObject : IRemoteObject
The IRemoteFloatObject provides run-time access to the value of a float variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from an IRemoteFloatObject is valid only during the lifetime of the actual object that it represents.
IRemoteFloatObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for an IRemoteFloatObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteFloatObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteFloatObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteFloat::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_FLOAT *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the value of this object. |
IRemoteFloatObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_FLOAT value)
| Parameter | Description |
| [in] value | The value that this object should be set to. |
IRemoteIntObject : IRemoteObject
The IRemoteIntObject provides run-time access to the value of an integer variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from an IRemoteIntObject is valid only during the lifetime of the actual object that it represents.
IRemoteIntObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for an IRemoteIntObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteIntObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteIntObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteInt::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_INT *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the value of this object. |
IRemoteIntObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_INT value)
| Parameter | Description |
| [in] value | The value that this object should be set to. |
IRemoteLong : IRemoteObject
The IRemoteLongObject provides run-time access to the value of a long variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from an IRemoteLongObject is valid only during the lifetime of the actual object that it represents.
IRemoteLongObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for an IRemoteLongObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteLongObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteLongObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteLong::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_LONG *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the value of this object. |
IRemoteLongObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_LONG value)
| Parameter | Description |
| [in] value | The value that this object should be set to. |
IRemoteShortObject : IRemoteObject
The IRemoteShortObject provides run-time access to the value of a double variable in a Java process. This interface inherits from IRemoteObject and adds two new methods.
The information obtained from an IRemoteShortObject is valid only during the lifetime of the actual object that it represents.
IRemoteShortObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_DATA_PRIMITIVE bit will be set for an IRemoteShortObject.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns an IRemoteField from which the type of this object can be determined. |
IRemoteShortObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)
IRemoteShortObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteShortObject::GetValue
The GetValue method returns the value of a primitive Java type.
HRESULT GetValue (JAVA_SHORT *pvalue)
| Parameter | Description |
| [out] pvalue | Returns the value of this object. |
IRemoteShortObject::SetValue
The SetValue method sets the value of a primitive Java type.
HRESULT SetValue (JAVA_SHORT value)
| Parameter | Description |
| [in] value | The value that this object should be set to. |
IRemoteArrayObject : IRemoteObject
The IRemoteArrayObject represents bound access to array objects of different types in a Java process. This interface inherits from IRemoteObject and adds three new methods.
The information obtained from an IRemoteArrayObject is valid only during the lifetime of the actual object that it represents.
IRemoteArrayObject::GetType
The GetType method returns the type of the object (an IRemoteField object). A debugger would normally then call the GetKind method of the IRemoteField interface to determine the FIELD_KIND of the object. The FIELD_KIND_ ARRAY bit will be set for an IRemoteArrayObject. The element type of the array can be determined by calling IRemoteField::GetType on the IRemoteField returned by the IRemoteArrayObject::GetType method.
HRESULT GetType(IRemoteField **ppType)
| Parameter | Description |
| [out] ppType | Returns and IRemoteField from which the type of this object can be determined. |
IRemoteArrayObject::SetBreakpoint
The SetBreakpoint method sets a data breakpoint on the object. The breakpoint fires when the value of the object changes.
HRESULT SetBreakpoint(void)Remarks
For classes, the value of the object changes when the object references a different instance of that class, not when any of the instance's data members change. For arrays, the object is considered changed when a new array is assigned to this object, not when any of its elements change.
IRemoteArrayObject::ClearBreakpoint
The ClearBreakpoint method clears a data breakpoint on the object previously set with the SetBreakpoint method.
HRESULT ClearBreakpoint(void)
IRemoteArrayObject::GetElements
The GetElements method returns an enumerator for the elements of this array, starting at index 0.
HRESULT GetElementObjects(IJavaEnumRemoteObject **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator for the elements of this array, starting at index 0. |
IRemoteArrayObject::GetSize
The GetElements method returns the number of elements in the array.
HRESULT GetSize(ULONG *pcElements)
| Parameter | Description |
| [out] pcElements | Returns the number of elements in the array. |
IRemoteArrayObject::GetElementValues
The GetElements method returns an enumerator for the values of the elements of this array, starting at index 0.
HRESULT GetElementValues(IJavaEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator for the values of the elements of this array, starting at index 0. |
IEnumRemoteObject : IUnknown
The IEnumRemoteObject interface is used to enumerate field objects in a class or container (an IRemoteClassObject, IRemoteClassObjectEx, or IRemoteContainerObject) and elements in an array (an IRemoteArrayObject).
IEnumRemoteObject::Next
The Next method is used to retrieve an array of IRemoteObject objects that represent the objects within a class, a container, or an array. The number of objects to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, IRemoteObject *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of objects that is retrieved. |
| [out] pceltFetched | The number of actual objects that was retrieved. |
IEnumRemoteObject::Skip
The Skip method moves the position of the enumeration forward. The number of objects to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of objects requested to be skipped. |
IEnumRemoteObject::Reset
The Reset method sets or resets the positions of the enumerator to the beginning of the list of objects.
HRESULT Reset(void)
IEnumRemoteObject::Clone
The Clone method copies a pointer to the current position in the list to another enumerator object.
HRESULT Clone(IJavaEnumRemoteObject **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the objects in a class, a container, or an array representing the current position in the list of objects. |
IEnumRemoteObject::GetCount
The GetCount method returns the number of objects being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of objects pointed to by the enumerator object. |
IJavaEnumRemoteObject : IEnumRemoteObject
The IJavaEnumRemoteObject interface is used to enumerate field objects in a class or container (an IRemoteClassObject, IRemoteClassObjectEx, or IRemoteContainerObject) and elements in an array (an IRemoteArrayObject).
IJavaEnumRemoteObject::Next
The Next method is used to retrieve an array of IRemoteObject objects that represent the objects within a class, a container, or an array. The number of objects to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, IRemoteObject *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of objects that is retrieved. |
| [out] pceltFetched | The number of actual objects that was retrieved. |
IJavaEnumRemoteObject::Skip
The Skip method moves the position of the enumeration forward. The number of objects to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of objects to be skipped. |
IJavaEnumRemoteObject::Reset
The Reset method sets or resets the positions of the enumerator to the beginning of the list of objects.
HRESULT Reset(void)
IJavaEnumRemoteObject::Clone
The Clone method copies a pointer to the current position in the list to another enumerator object.
HRESULT Clone(IJavaEnumRemoteObject **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the objects in a class, a container, or an array representing the current position in the list of objects. |
IJavaEnumRemoteObject::GetCount
The GetCount method returns the number of objects being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of objects pointed to by the enumerator object. |
IJavaEnumRemoteObject::GetNext
The GetNext method is used to retrieve the next IRemoteObject object being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(IRemoteObject **ppiro)
| Parameter | Description |
| [out] ppiro | The pointer to the IRemoteObject object that is retrieved. |
IEnumRemoteValue : IUnknown
The IEnumRemoteValue interface and the interfaces that inherit from it are used to enumerate and retrieve the values of elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example). These interfaces provides contain type-safe methods for enumerating values of built-in types. These interfaces can only be used to retrieve the values of these Java primitive types.
IEnumRemoteValue::Skip
The Skip method moves the position of the array or data element enumeration forward. The number of array or data elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index or data list) to the beginning of the array or list.
HRESULT Reset(void)
IEnumRemoteValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteValue::GetCount
The GetCount method returns the number of elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements in the array pointed to by the enumerator object. |
IEnumRemoteBooleanValue : IEnumRemoteValue
The IEnumRemoteBooleanValue interface is used to enumerate and retrieve the boolean values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type boolean. This interface can only be used to retrieve the values of boolean data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteBooleanValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteBooleanValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteBooleanValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteBooleanValue::GetCount
The GetCount method returns the number of elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements in the array pointed to by the enumerator object. |
IEnumRemoteBooleanValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_BOOLEAN *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteByteValue : IEnumRemoteValue
The IEnumRemoteByteValue interface is used to enumerate and retrieve the byte values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type byte. This interface can only be used to retrieve the values of byte data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteByteValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteByteValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteByteValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteByteValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IEnumRemoteByteValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_BYTE *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteCharValue : IEnumRemoteValue
The IEnumRemoteCharValue interface is used to enumerate and retrieve the char values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type char. This interface can only be used to retrieve the values of char data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteCharValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteCharValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteCharValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteCharValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements that are available through this enumerator object. |
IEnumRemoteCharValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_CHAR *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteDoubleValue : IEnumRemoteValue
The IEnumRemoteDoubleValue interface is used to enumerate and retrieve the double values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type double. This interface can only be used to retrieve the values of double data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteDoubleValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteDoubleValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteDoubleValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteDoubleValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IEnumRemoteDoubleValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_DOUBLE *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteFloatValue : IEnumRemoteValue
The IEnumRemoteFloatValue interface is used to enumerate and retrieve the float values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type float. This interface can only be used to retrieve the values of float data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteFloatValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteFloatValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteFloatValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteFloatValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IEnumRemoteFloatValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_FLOAT *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteIntValue : IEnumRemoteValue
The IEnumRemoteIntValue interface is used to enumerate and retrieve the integer values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type int. This interface can only be used to retrieve the values of int data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteIntValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteIntValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteIntValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteIntValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IEnumRemoteIntValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_INT *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteLongValue : IEnumRemoteValue
The IEnumRemoteLongValue interface is used to enumerate and retrieve the long values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type long. This interface can only be used to retrieve the values of long data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteLongValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteLongValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteLongValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteLongValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IEnumRemoteLongValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_LONG *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IEnumRemoteShortValue : IEnumRemoteValue
The IEnumRemoteShortValue interface is used to enumerate and retrieve the short values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type short. This interface can only be used to retrieve the values of short data types.
This interface inherits from the IEnumRemoteValue interface adding one method.
IEnumRemoteShortValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IEnumRemoteShortValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IEnumRemoteShortValue::Clone
The Clone method copies a pointer to the current position in the array or data list to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IEnumRemoteShortValue::GetCount
The GetCount method returns the number of elements in the array or data list being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IEnumRemoteShortValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_SHORT *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of data values requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that was retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteBooleanValue : IEnumRemoteBooleanValue
The IJavaEnumRemoteBooleanValue interface is used to enumerate and retrieve the boolean values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type boolean. This interface can only be used to retrieve the values of boolean data types.
This interface inherits from the IEnumRemoteBooleanValue interface adding one method.
IJavaEnumRemoteBooleanValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteBooleanValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteBooleanValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteBooleanValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteBooleanValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_BOOLEAN *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumBooleanValue::GetNext
The GetNext method is used to retrieve the boolean value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_BOOLEAN *pjb)
| Parameter | Description |
| [out] pjb | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when it is changed.
IJavaEnumRemoteByteValue : IEnumRemoteByteValue
The IJavaEnumRemoteByteValue interface is used to enumerate and retrieve the byte values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type byte. This interface can only be used to retrieve the values of byte data types.
This interface inherits from the IEnumRemoteByteValue interface adding one method.
IJavaEnumRemoteByteValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteByteValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteByteValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteByteValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteByteValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_BYTE *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cached these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteByteValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_BYTE *pjbyte)
| Parameter | Description |
| [out] pjbyte | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
IJavaEnumRemoteCharValue : IEnumRemoteCharValue
The IJavaEnumRemoteCharValue interface is used to enumerate and retrieve the char values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type char. This interface can only be used to retrieve the values of char data types.
This interface inherits from the IEnumRemoteCharValue interface adding one method.
IJavaEnumRemoteCharValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteCharValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteCharValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteCharValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteCharValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_CHAR *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteCharValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_CHAR *pjch)
| Parameter | Description |
| [out] pjch | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
IJavaEnumRemoteDoubleValue : IEnumRemoteDoubleValue
The IJavaEnumRemoteDoubleValue interface is used to enumerate and retrieve the double values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type double. This interface can only be used to retrieve the values of double data types.
This interface inherits from the IEnumRemoteDoubleValue interface adding one method.
IJavaEnumRemoteDoubleValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteDoubleValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteDoubleValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteDoubleValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteDoubleValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_DOUBLE *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteDoubleValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_DOUBLE *pjdbl)
| Parameter | Description |
| [out] pjdbl | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
IJavaEnumRemoteFloatValue : IEnumRemoteFloatValue
The IJavaEnumRemoteFloatValue interface is used to enumerate and retrieve the float values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type float. This interface can only be used to retrieve the values of float data types.
This interface inherits from the IEnumRemoteFloatValue interface adding one method.
IJavaEnumRemoteFloatValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteFloatValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteFloatValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteFloatValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteFloatValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_FLOAT *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteFloatValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_FLOAT *pjflt)
| Parameter | Description |
| [out] pjflt | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
IJavaEnumRemoteIntValue : IEnumRemoteIntValue
The IJavaEnumRemoteIntValue interface is used to enumerate and retrieve the integer values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type int. This interface can only be used to retrieve the values of int data types.
This interface inherits from the IEnumRemoteIntValue interface adding one method.
IJavaEnumRemoteIntValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteIntValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteIntValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteIntValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteIntValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_INT *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteIntValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_INT *pjn)
| Parameter | Description |
| [out] pjn | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
IJavaEnumRemoteLongValue : IEnumRemoteLongValue
The IJavaEnumRemoteLongValue interface is used to enumerate and retrieve the long values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type long. This interface can only be used to retrieve the values of long data types.
This interface inherits from the IEnumRemoteLongValue interface adding one method.
IJavaEnumRemoteLongValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteLongValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteLongValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteLongValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteLongValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_LONG *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteLongValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_LONG *pjl)
| Parameter | Description |
| [out] pjl | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
IJavaEnumRemoteShortValue : IEnumRemoteShortValue
The IJavaEnumRemoteShortValue interface is used to enumerate and retrieve the short values for elements of an array (IRemoteArrayObject) and other data variables (class data fields and method parameters, for example) of type short. This interface can only be used to retrieve the values of short data types.
This interface inherits from the IEnumRemoteShortValue interface adding one method.
IJavaEnumRemoteShortValue::Skip
The Skip method moves the position of the array enumeration (index) forward. The number of data or array elements to be skipped is based on a parameter passed to the method.
HRESULT Skip(ULONG celt)
| Parameter | Description |
| [in] celt | The number of array elements requested to be skipped. |
IJavaEnumRemoteShortValue::Reset
The Reset method sets or resets the positions of the enumerator (the array index) to the beginning of the array.
HRESULT Reset(void)
IJavaEnumRemoteShortValue::Clone
The Clone method copies a pointer to the current position in the array to another enumerator object.
HRESULT Clone(IEnumRemoteValue **ppEnum)
| Parameter | Description |
| [out] ppEnum | Returns an enumerator object pointing to the element in the array representing the current position in the array. |
IJavaEnumRemoteShortValue::GetCount
The GetCount method returns the number of data elements in the array being pointed to by the enumerator object.
HRESULT GetCount (ULONG * pcelt)
| Parameter | Description |
| [out] pcelt | The number of elements available through this enumerator object. |
IJavaEnumRemoteShortValue::Next
The Next method is used to retrieve the value of several array or data elements pointed to by the enumerator object. The number of values to be retrieved is passed as one of the parameters; the enumeration pointer is incremented by that amount.
HRESULT Next(ULONG celt, JAVA_SHORT *rgelt[], ULONG *pceltFetched)
| Parameter | Description |
| [in] celt | The number of objects requested to be retrieved. |
| [out] drgelt | The pointer to the array of values that is retrieved. |
| [out] pceltFetched | The number of actual values that was retrieved. |
Remarks
The data values retrieved by this method are dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache these values unless data breakpoints are set on these data elements to indicate when these data elements are changed.
IJavaEnumRemoteShortValue::GetNext
The GetNext method is used to retrieve the value of the next array element or data item being pointed to by the enumerator object and increments the enumeration pointer by one.
HRESULT GetNext(JAVA_SHORT *pjsh)
| Parameter | Description |
| [out] pjsh | A pointer to the current value of this data item. |
Remarks
The data value retrieved by this method is dynamic and may be changed after further execution of the Java process. Consequently, a debugger cannot cache this value unless a data breakpoint is set on this data element to indicate when this data element is changed.
