Package com.sun.jna.platform.win32.COM.util

Klasse ProxyObject

java.lang.Object

com.sun.jna.platform.win32.COM.util.ProxyObject

Alle implementierten Schnittstellen:

IConnectionPoint, IDispatch, IRawDispatchHandle, IUnknown, InvocationHandler

public class ProxyObject
extends Object
implements InvocationHandler, IDispatch, IRawDispatchHandle, IConnectionPoint

This object acts as the invocation handler for interfaces annotated with ComInterface. It wraps all (necessary) low level COM calls and dispatches them through the COM runtime.

The caller of the methods is responsible for correct initialization of the COM runtime and appropriate thread-handling - depending on the choosen handling model.

Siehe auch:

• MSDN - Processes, Threads, and Apartments
• MSDN - Understanding and Using COM Threading Models

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
ProxyObject(Class<?> theInterface, IDispatch rawDispatch, ObjectFactory factory)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
IComEventCallbackCookie	advise(Class<?> comEventCallbackInterface, IComEventCallbackListener comEventCallbackListener)	Set up the comEventCallbackListener to receive callback events from the target COM object
void	dispose()
boolean	equals(Object arg)
protected void	finalize()
<T> T	getProperty(Class<T> returnType, OaIdl.DISPID dispID, Object... args)
<T> T	getProperty(Class<T> returnType, String name, Object... args)
IDispatch	getRawDispatch()
int	hashCode()
Object	invoke(Object proxy, Method method, Object[] args)
<T> T	invokeMethod(Class<T> returnType, OaIdl.DISPID dispID, Object... args)
<T> T	invokeMethod(Class<T> returnType, String name, Object... args)
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, IDispatch pDisp, OaIdl.DISPID dispId)	Veraltet.
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, IDispatch pDisp, OaIdl.DISPID dispId, Variant.VARIANT pArg)	Veraltet.
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, IDispatch pDisp, OaIdl.DISPID dispId, Variant.VARIANT[] pArgs)	Veraltet.
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, IDispatch pDisp, String name)	Veraltet.
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, IDispatch pDisp, String name, Variant.VARIANT pArg)	Veraltet.
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, IDispatch pDisp, String name, Variant.VARIANT[] pArgs)	Veraltet.
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, OaIdl.DISPID dispId)
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, OaIdl.DISPID dispId, Variant.VARIANT pArg)
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, OaIdl.DISPID dispId, Variant.VARIANT[] pArgs)
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, String name)
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, String name, Variant.VARIANT pArg)
protected WinNT.HRESULT	oleMethod(int nType, Variant.VARIANT.ByReference pvResult, String name, Variant.VARIANT[] pArgs)
<T> T	queryInterface(Class<T> comInterface)	Returns a proxy object for the given interface.
protected OaIdl.DISPID	resolveDispId(IDispatch pDisp, String name)	Veraltet.
protected OaIdl.DISPID	resolveDispId(String name)
<T> void	setProperty(OaIdl.DISPID dispId, T value)
<T> void	setProperty(String name, T value)
String	toString()
void	unadvise(Class<?> comEventCallbackInterface, IComEventCallbackCookie cookie)	Stop listening for callback events

Von Klasse geerbte Methoden java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Konstruktordetails

ProxyObject

public ProxyObject(Class<?> theInterface,
 IDispatch rawDispatch,
 ObjectFactory factory)

Methodendetails

finalize

protected void finalize()
                 throws Throwable

Setzt außer Kraft:

finalize in Klasse Object

Löst aus:

Throwable

dispose

public void dispose()

getRawDispatch

public IDispatch getRawDispatch()

Angegeben von:

getRawDispatch in Schnittstelle IRawDispatchHandle

equals

public boolean equals(Object arg)

Setzt außer Kraft:

equals in Klasse Object

hashCode

public int hashCode()

Setzt außer Kraft:

hashCode in Klasse Object

toString

public String toString()

Setzt außer Kraft:

toString in Klasse Object

invoke

public Object invoke(Object proxy,
 Method method,
 Object[] args)
              throws Throwable

Angegeben von:

invoke in Schnittstelle InvocationHandler

Löst aus:

Throwable

advise

public IComEventCallbackCookie advise(Class<?> comEventCallbackInterface,
 IComEventCallbackListener comEventCallbackListener)
                               throws COMException

Beschreibung aus Schnittstelle kopiert: IConnectionPoint

Set up the comEventCallbackListener to receive callback events from the target COM object

Angegeben von:

advise in Schnittstelle IConnectionPoint

Parameter:

comEventCallbackInterface - - the COM interface that the listener will receive events from

comEventCallbackListener - - and object that will receive the callback events

Gibt zurück:

- a cookie that can be used to detach (unadvise) the event callback listener throws COMException if an error occurs trying to set up the listener on the target COM object, see exception cause for details.

Löst aus:

COMException

unadvise

public void unadvise(Class<?> comEventCallbackInterface,
 IComEventCallbackCookie cookie)
              throws COMException

Beschreibung aus Schnittstelle kopiert: IConnectionPoint

Stop listening for callback events

Angegeben von:

unadvise in Schnittstelle IConnectionPoint

Parameter:

comEventCallbackInterface - - the interface that is being listened to

cookie - - the cookie that was returned when advise was called

Löst aus:

COMException

setProperty

public <T> void setProperty(String name,
 T value)

Angegeben von:

setProperty in Schnittstelle IDispatch

setProperty

public <T> void setProperty(OaIdl.DISPID dispId,
 T value)

Angegeben von:

setProperty in Schnittstelle IDispatch

getProperty

public <T> T getProperty(Class<T> returnType,
 String name,
 Object... args)

Angegeben von:

getProperty in Schnittstelle IDispatch

getProperty

public <T> T getProperty(Class<T> returnType,
 OaIdl.DISPID dispID,
 Object... args)

Angegeben von:

getProperty in Schnittstelle IDispatch

invokeMethod

public <T> T invokeMethod(Class<T> returnType,
 String name,
 Object... args)

Angegeben von:

invokeMethod in Schnittstelle IDispatch

invokeMethod

public <T> T invokeMethod(Class<T> returnType,
 OaIdl.DISPID dispID,
 Object... args)

Angegeben von:

invokeMethod in Schnittstelle IDispatch

queryInterface

public <T> T queryInterface(Class<T> comInterface)
                     throws COMException

Beschreibung aus Schnittstelle kopiert: IUnknown

Returns a proxy object for the given interface. Assuming that the interface is annotated with a ComInterface annotation that provides a valid iid.

Will throw COMException if an error occurs trying to retrieve the requested interface, see exception cause for details.

Angegeben von:

queryInterface in Schnittstelle IUnknown

Löst aus:

COMException

resolveDispId

protected OaIdl.DISPID resolveDispId(String name)

oleMethod

protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 String name,
 Variant.VARIANT pArg)
                           throws COMException

Löst aus:

COMException

oleMethod

protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 OaIdl.DISPID dispId,
 Variant.VARIANT pArg)
                           throws COMException

Löst aus:

COMException

oleMethod

protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 String name)
                           throws COMException

Löst aus:

COMException

oleMethod

protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 OaIdl.DISPID dispId)
                           throws COMException

Löst aus:

COMException

oleMethod

protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 String name,
 Variant.VARIANT[] pArgs)
                           throws COMException

Löst aus:

COMException

oleMethod

protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 OaIdl.DISPID dispId,
 Variant.VARIANT[] pArgs)
                           throws COMException

Löst aus:

COMException

resolveDispId

@Deprecated
protected OaIdl.DISPID resolveDispId(IDispatch pDisp,
 String name)

Veraltet.

oleMethod

@Deprecated
protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 IDispatch pDisp,
 String name,
 Variant.VARIANT pArg)
                           throws COMException

Veraltet.

Löst aus:

COMException

oleMethod

@Deprecated
protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 IDispatch pDisp,
 OaIdl.DISPID dispId,
 Variant.VARIANT pArg)
                           throws COMException

Veraltet.

Löst aus:

COMException

oleMethod

@Deprecated
protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 IDispatch pDisp,
 String name)
                           throws COMException

Veraltet.

Löst aus:

COMException

oleMethod

@Deprecated
protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 IDispatch pDisp,
 OaIdl.DISPID dispId)
                           throws COMException

Veraltet.

Löst aus:

COMException

oleMethod

@Deprecated
protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 IDispatch pDisp,
 String name,
 Variant.VARIANT[] pArgs)
                           throws COMException

Veraltet.

Löst aus:

COMException

oleMethod

@Deprecated
protected WinNT.HRESULT oleMethod(int nType,
 Variant.VARIANT.ByReference pvResult,
 IDispatch pDisp,
 OaIdl.DISPID dispId,
 Variant.VARIANT[] pArgs)
                           throws COMException

Veraltet.

Löst aus:

COMException