Marshal.GetIDispatchForObject(Object) 메서드

정의

관리되는 개체에서 IDispatch 인터페이스를 반환합니다.Returns an IDispatch interface from a managed object.

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

매개 변수

o
Object

IDispatch 인터페이스가 요청되는 개체입니다.The object whose IDispatch interface is requested.

반환

IntPtr

o 매개 변수에 대한 IDispatch 포인터입니다.The IDispatch pointer for the o parameter.

특성

예외

o가 요청된 인터페이스를 지원하지 않는 경우o does not support the requested interface.

설명

관리 코드에서 인터페이스를 사용 하 여 직접 작업 하는 경우는 거의 IDispatch 없습니다.In managed code, you seldom work directly with the IDispatch interface. 그러나 GetIDispatchForObject 는 COM 개체 매개 변수를 형식으로 노출 하는 메서드를 호출 IntPtr 하거나 사용자 지정 마샬링을 사용 하는 경우에 유용 합니다.However, GetIDispatchForObject is useful when calling a method that exposes a COM object parameter as an IntPtr type, or with custom marshaling. 이 메서드를 사용 하 여 개체를 호출 하면 포인터를 반환 하기 전에 인터페이스 포인터에서 참조 횟수가 증가 합니다.Calling an object with this method causes the reference count to increment on the interface pointer before the pointer is returned. 포인터를 사용 하 Marshal.Release 여 완료 한 후에는 항상를 사용 하 여 참조 횟수를 감소 시킵니다.Always use Marshal.Release to decrement the reference count once you have finished with the pointer.

관리 되는 개체에 대해이 메서드를 사용 하 여 개체에 대 한 COM 호출 가능 래퍼에 대 한 인터페이스 포인터를 가져올 수도 있습니다.You can also use this method on a managed object to obtain an interface pointer to the COM callable wrapper for the object. 자세한 내용은 COM 호출 가능 래퍼를 참조 하세요.For additional information, see COM Callable Wrapper.

적용 대상

추가 정보