다음을 통해 공유

Marshal.GetIDispatchForObject 메서드

  • 아티클

관리되는 개체에서 IDispatch 인터페이스를 반환합니다.

네임스페이스: System.Runtime.InteropServices
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Public Shared Function GetIDispatchForObject ( _
    o As Object _
) As IntPtr
‘사용 방법
Dim o As Object
Dim returnValue As IntPtr

returnValue = Marshal.GetIDispatchForObject(o)

public static IntPtr GetIDispatchForObject (
    Object o
)

public:
static IntPtr GetIDispatchForObject (
    Object^ o
)

public static IntPtr GetIDispatchForObject (
    Object o
)

public static function GetIDispatchForObject (
    o : Object
) : IntPtr

매개 변수

  • o
    IDispatch 인터페이스가 필요한 개체입니다.

반환 값

o 매개 변수에 대한 IDispatch 포인터입니다.

예외

예외 형식 조건

InvalidCastException

o가 요청된 인터페이스를 지원하지 않는 경우

설명

관리 코드에서는 IDispatch 인터페이스를 직접 사용하는 경우가 거의 없습니다. 그러나 GetIDispatchForObject는 COM 개체 매개 변수를 IntPtr 형식으로 노출하는 메서드를 호출할 때 또는 사용자 지정 마샬링을 사용할 때 유용합니다. 이 메서드로 개체를 호출하면 인터페이스 포인터가 반환되기 전에 해당 포인터에서 참조 횟수가 증가합니다. 일단 포인터 작업을 마친 후에는 항상 Marshal.Release를 사용하여 참조 횟수를 감소시킵니다.

또한 관리되는 개체에 이 메서드를 사용하여 개체의 COM 호출 가능 래퍼에 대한 인터페이스 포인터를 얻을 수도 있습니다. 자세한 내용은 CCW을 참조하십시오.

참고

이 메서드는 신뢰할 수 없는 코드에서 호출되지 않도록 SecurityAction.LinkDemand를 사용합니다. SecurityPermissionAttribute.UnmanagedCode 권한을 가지려면 직접 실행 호출자만 필요합니다. 부분적으로 신뢰할 수 있는 코드에서 특정 코드를 호출하는 경우 유효성 검사 없이 사용자 입력을 Marshal 클래스 메서드로 전달하지 마십시오. LinkDemand 멤버 사용에 대한 중요한 제한 사항은 Demand와 LinkDemand 비교를 참조하십시오.

.NET Framework 보안

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0에서 지원

참고 항목

참조

Marshal 클래스
Marshal 멤버
System.Runtime.InteropServices 네임스페이스
Release
GetIDispatchForObjectInContext