Marshal.GetIDispatchForObject(Object) Método

Definição

Retorna uma interface IDispatch de um objeto gerenciado.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

Parâmetros

o
Object

O objeto cuja interface IDispatch é solicitada.The object whose IDispatch interface is requested.

Retornos

O ponteiro IDispatch para o parâmetro o.The IDispatch pointer for the o parameter.

Atributos

Exceções

o não dá suporte à interface solicitada.o does not support the requested interface.

Comentários

No código gerenciado, você raramente trabalha diretamente com a interface IDispatch.In managed code, you seldom work directly with the IDispatch interface. No entanto, GetIDispatchForObject é útil ao chamar um método que expõe um parâmetro de objeto COM como um tipo de IntPtr ou com marshaling personalizado.However, GetIDispatchForObject is useful when calling a method that exposes a COM object parameter as an IntPtr type, or with custom marshaling. Chamar um objeto com esse método faz com que a contagem de referência seja incrementada no ponteiro da interface antes que o ponteiro seja retornado.Calling an object with this method causes the reference count to increment on the interface pointer before the pointer is returned. Sempre use Marshal.Release para decrementar a contagem de referência depois de terminar com o ponteiro.Always use Marshal.Release to decrement the reference count once you have finished with the pointer.

Você também pode usar esse método em um objeto gerenciado para obter um ponteiro de interface para a COM Callable Wrapper do objeto.You can also use this method on a managed object to obtain an interface pointer to the COM callable wrapper for the object. Para obter informações adicionais, consulte com callable wrapper com.For additional information, see COM Callable Wrapper.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a

Veja também