Marshal.GetIDispatchForObject(Object) Metodo

Definizione

Restituisce un'interfaccia IDispatch da un oggetto gestito.Returns an IDispatch interface from a managed object.

public:
 static IntPtr GetIDispatchForObject(System::Object ^ o);
[System.Security.SecurityCritical]
public static IntPtr GetIDispatchForObject (object o);
static member GetIDispatchForObject : obj -> nativeint
Public Shared Function GetIDispatchForObject (o As Object) As IntPtr

Parametri

o
Object

Oggetto di cui è richiesta l'interfaccia IDispatch.The object whose IDispatch interface is requested.

Restituisce

Puntatore IDispatch per il parametro o.The IDispatch pointer for the o parameter.

Attributi

Eccezioni

o non supporta l'interfaccia richiesta.o does not support the requested interface.

Commenti

Nel codice gestito, raramente si utilizza direttamente l'interfaccia IDispatch.In managed code, you seldom work directly with the IDispatch interface. Tuttavia, GetIDispatchForObject è utile quando si chiama un metodo che espone un parametro dell'oggetto COM come tipo di IntPtr o con marshalling personalizzato.However, GetIDispatchForObject is useful when calling a method that exposes a COM object parameter as an IntPtr type, or with custom marshaling. La chiamata a un oggetto con questo metodo determina l'incremento del conteggio dei riferimenti sul puntatore a interfaccia prima che venga restituito il puntatore.Calling an object with this method causes the reference count to increment on the interface pointer before the pointer is returned. Usare sempre Marshal.Release per decrementare il conteggio dei riferimenti una volta terminato il puntatore.Always use Marshal.Release to decrement the reference count once you have finished with the pointer.

È anche possibile usare questo metodo su un oggetto gestito per ottenere un puntatore a interfaccia per l'COM Callable Wrapper per l'oggetto.You can also use this method on a managed object to obtain an interface pointer to the COM callable wrapper for the object. Per ulteriori informazioni, vedere COM Callable Wrapper.For additional information, see COM Callable Wrapper.

Sicurezza

SecurityCriticalAttribute
richiede l'attendibilità totale per il chiamante immediato.requires full trust for the immediate caller. Questo membro non può essere utilizzato da codice parzialmente attendibile o trasparente.This member cannot be used by partially trusted or transparent code.

Si applica a

Vedi anche