Microsoft SDK for Java

invokeSubv

The invokeSubv method of the Dispatch Class contains the following signatures:

invokeSubv(Object pDispatch, _Guid iid, String dispName, int dispID, int lcid, int wFlags, Variant vArg[], int uArgErr[])
invokeSubv(Object pDispatch, String dispName, int wFlags, Variant vArg[], int uArgErr[])
invokeSubv(Object pDispatch, int dispid, int wFlags, Variant vArg[], int uArgErr[])

invokeSubv(Object pDispatch, _Guid iid, String dispName, int dispID, int lcid, int wFlags, Variant vArg[], int uArgErr[])

Invokes a subroutine or sets a property on an ActiveX Automation object. This method is very similar to invokev, but it does not accept a return value from the method.

Syntax

public static void invokeSubv(Object pDispatch, _Guid iid, String dispName, int dispID, int lcid, int wFlags, Variant vArg[], int uArgErr[]);

Parameters

pDispatch The Java proxy of the ActiveX Automation object.
iid The identifier of the interface that is called. If the value is null, this parameter defaults to IID_IDispatch.
dispName The name of the method or property that is invoked. If the value is null, dispID is used.
dispID The identifier of the method or property. Unless dispName is null, this parameter is ignored.
lcid The locale ID.
wFlags The type of access, which must be Dispatch.Method, Dispatch.Get, Dispatch.Put, or Dispatch.PutRef.
vArg The arguments of the method or property.
uArgErr An optional one-element array. If an error occurs, uArgErr receives the index of the offending parameter.

Remarks

This method is very similar to invokev, but it does not accept a return value from the method. Some language implementations distinguish between functions and subroutines; subroutines written in such languages cannot be called as if they were functions. If the invoked method does not return a value, use invokeSubv to avoid this problem.

invokeSubv(Object pDispatch, String dispName, int wFlags, Variant vArg[], int uArgErr[])

Invokes a subroutine or sets a property on an ActiveX Automation object. This method is easier to call than the full invokeSubv method, but it does not allow you to specify the interface IID or the locale, and the method must be identified by name.

Syntax

public static void invokeSubv(Object pDispatch, String dispName, int wFlags, Variant vArg[], int uArgErr[]);

Parameters

pDispatch The Java proxy of the ActiveX Automation object.
dispName The name of the method or property.
wFlags The type of access, which must be Dispatch.Method, Dispatch.Get, Dispatch.Put, or Dispatch.PutRef.
vArg The arguments of the method or property.
uArgErr An optional one-element array. If an error occurs, uArgErr receives the index of the offending parameter.

Remarks

This method is very similar to invokev, but it does not accept a return value from the method. Some language implementations distinguish between functions and subroutines; subroutines written in such languages cannot be called as if they were functions. If the invoked method does not return a value, use invokeSubv to avoid this problem.

invokeSubv(Object pDispatch, int dispid, int wFlags, Variant vArg[], int uArgErr[])

Invokes a subroutine or sets a property on an ActiveX Automation object. This method is very similar to invokev, but it does not accept a return value from the method. Some language implementations do not invoke subroutines as if they were functions. If the invoked method does not return a value, use invokeSubv to avoid problems. This method is easier to call than the full invokeSubv method. However, it does not enable you to specify the interface identifier or the locale, and the method must be identified by dispid.

Syntax

public static void invokeSubv(Object pDispatch, int dispid, int wFlags, Variant vArg[], int uArgErr[]);

Parameters

pDispatch The Java proxy of the ActiveX Automation object.
dispID The identifier of the method or property.
wFlags The type of access, which must be Dispatch.Method, Dispatch.Get, Dispatch.Put, or Dispatch.PutRef.
vArg The arguments of the method or property.
uArgErr An optional one-element array. If an error occurs, uArgErr receives the index of the offending parameter.

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