ErrorWrapper 클래스

정의

경고

이 API는 현재 사용되지 않습니다.

마샬러가 VT_ERROR으로 마샬링할 개체를 래핑합니다.Wraps objects the marshaler should marshal as a VT_ERROR.

public ref class ErrorWrapper sealed
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
[System.Obsolete("ErrorWrapper and support for marshalling to the VARIANT type may be unavailable in future releases.")]
public sealed class ErrorWrapper
type ErrorWrapper = class
Public NotInheritable Class ErrorWrapper
상속
ErrorWrapper
특성

예제

다음 코드 예제에서는 먼저 COM에서 Int32 개체로 마샬링된 유일한 Int32 개체를 보여 줍니다.The following code example first demonstrates a lone Int32 object marshaled back from COM as an Int32 object. 그런 다음 COM에서 UInt32 배열로 마샬링되는 Int32 배열을 보여 줍니다.It then demonstrates an Int32 array marshaled back from COM as a UInt32 array.

// Scenario 1:  
// Pass a single value.  
Int32 x = 3;  
Object o = new ErrorWrapper(x);  
// Pass 'o' to COM.  
// On the return trip, 'o' has been unwrapped and is still an Int32 object.  
Int32 y = (Int32)o;  
Scenario 2:  
// Pass an array of values.  
Int32[] arr = new Int32[3];  
Object o = new ErrorWrapper(arr);  
// Pass 'o' to COM.  
// On the return trip, 'o' has been unwrapped and is now a UInt32[] array.  
UInt32[ ] arr2 = (UInt32[])o;  

설명

기본적으로 Object 형식 인수는 VARIANT 형식으로 마샬링됩니다. 여기서 개체 형식은 VARIANTVARTYPE 값을 결정 합니다.By default, Object type arguments are marshaled as a VARIANT type, where the object type determines the VARTYPE value of the VARIANT.

ErrorWrapper 형식은 VT_ERROR형식의 VARIANT 마샬링될 Object 형식으로 전달 되어야 합니다. 그렇지 않으면 ErrorWrapper 형식이 정수로 마샬링됩니다.The ErrorWrapper type must to be passed as an Object type to be marshaled as a VARIANT of type VT_ERROR, otherwise the ErrorWrapper type is marshaled as an integer.

다음 표에서 관리 되는 네이티브 함수 호출에서 마샬링 플랫폼을 사용 하 여 호출 합니다.The following table illustrates marshaling in a managed call to a native function, using platform invoke.

관리 되는 시그니처 매개 변수Managed signature parameter pArr 값pArr value 마샬링될Marshaled as
PArr ErrorWrapperErrorWrapper[] pArr ErrorWrapper(77)의 ErrorWrapper [10]ErrorWrapper[10] of ErrorWrapper(77) Int[10]
개체 pArrObject[] pArr ErrorWrapper(77)의 ErrorWrapper [10]ErrorWrapper[10] of ErrorWrapper(77) VT_ERRORVARIANT[10]VARIANT[10] of VT_ERROR
개체 pArrObject[] pArr ErrorWrapper(77) 개체 [10]Object[10] of ErrorWrapper(77) VT_ERRORVARIANT[10]VARIANT[10] of VT_ERROR

다음 표에서 관리 되는 COM 런타임 호출 가능 래퍼 (RCW)를 사용 하 여 네이티브 함수 호출에서 마샬링 데이터를 보여 줍니다.The following table illustrates marshaling data in a managed call to a native function, using COM runtime callable wrappers (RCW).

관리 되는 시그니처 매개 변수Managed signature parameter pArr 값pArr value 마샬링될Marshaled as
PArr ErrorWrapperErrorWrapper[] pArr ErrorWrapper(77)의 ErrorWrapper [10]ErrorWrapper[10] of ErrorWrapper(77) Int[10]
개체 pArrObject[] pArr ErrorWrapper(77)의 ErrorWrapper [10]ErrorWrapper[10] of ErrorWrapper(77) SafeArrayTypeMismatch 예외SafeArrayTypeMismatch exception
개체 pArrObject[] pArr ErrorWrapper(77) 개체 [10]Object[10] of ErrorWrapper(77) SAFEARRAY(VARIANT)

ErrorWrapper 개체는 COM에서 다시 전달 된 후 VT_ERROR 형식으로 마샬링되지 않습니다.Note that ErrorWrapper objects are not marshaled as type VT_ERROR after they are passed back from COM. 단일 값은 COM에서 형식 VT_I4로 다시 마샬링되는 반면, 배열은 COM에서 형식 VT_UI4로 다시 마샬링됩니다.A single value is marshaled back from COM as type VT_I4, while arrays are marshaled back from COM as type VT_UI4.

VT_ERROR에 대 한 자세한 내용은 MSDN library의 VARENUM::VT_ERROR에 대 한 기존 설명서를 참조 하세요.For more information on VT_ERROR, please see the existing documentation for VARENUM::VT_ERROR in the MSDN library.

생성자

ErrorWrapper(Exception)

제공된 예외에 해당하는 HRESULT를 사용하여 ErrorWrapper 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ErrorWrapper class with the HRESULT that corresponds to the exception supplied.

ErrorWrapper(Int32)

오류의 HRESULT를 사용하여 ErrorWrapper 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ErrorWrapper class with the HRESULT of the error.

ErrorWrapper(Object)

오류의 HRESULT가 들어 있는 개체를 사용하여 ErrorWrapper 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ErrorWrapper class with an object containing the HRESULT of the error.

속성

ErrorCode

래퍼의 오류 코드를 가져옵니다.Gets the error code of the wrapper.

메서드

Equals(Object)

지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

적용 대상