ErrorWrapper ErrorWrapper ErrorWrapper ErrorWrapper Class

定義

警告

この 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
継承
ErrorWrapperErrorWrapperErrorWrapperErrorWrapper
属性

次のコード例は最初、唯一示しますInt32として COM からオブジェクトをInt32オブジェクト。The following code example first demonstrates a lone Int32 object marshaled back from COM as an Int32 object. 後を示しています、Int32として COM から配列をUInt32配列。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型、オブジェクトの種類を決定、VARTYPEの値、VARIANTします。By default, Object type arguments are marshaled as a VARIANT type, where the object type determines the VARTYPE value of the VARIANT.

ErrorWrapper入力として渡される必要があります、Object型としてマーシャ リングされる、VARIANT型のVT_ERROR、それ以外の場合、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
ErrorWrapper:operator[] pArrErrorWrapper[] pArr ErrorWrapper(77) の ErrorWrapper [10]ErrorWrapper[10] of ErrorWrapper(77) Int[10]
オブジェクト [pArrObject[] pArr ErrorWrapper(77) の ErrorWrapper [10]ErrorWrapper[10] of ErrorWrapper(77) VARIANT[10]VT_ERRORVARIANT[10] of VT_ERROR
オブジェクト [pArrObject[] pArr ErrorWrapper(77) のオブジェクト [10]Object[10] of ErrorWrapper(77) VARIANT[10]VT_ERRORVARIANT[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
ErrorWrapper:operator[] pArrErrorWrapper[] 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オブジェクト型としてマーシャ リングされないVT_ERRORCOM から返されるため後Note that ErrorWrapper objects are not marshaled as type VT_ERROR after they are passed back from COM. 1 つの値がから 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、既存のドキュメントをご覧くださいVARENUM::VT_ERRORMSDN ライブラリ。For more information on VT_ERROR, please see the existing documentation for VARENUM::VT_ERROR in the MSDN library.

コンストラクター

ErrorWrapper(Exception) ErrorWrapper(Exception) ErrorWrapper(Exception) ErrorWrapper(Exception)

新しいインスタンスを初期化、ErrorWrapperクラスが提供される例外に対応する HRESULT を使用します。Initializes a new instance of the ErrorWrapper class with the HRESULT that corresponds to the exception supplied.

ErrorWrapper(Int32) ErrorWrapper(Int32) ErrorWrapper(Int32) ErrorWrapper(Int32)

新しいインスタンスを初期化、ErrorWrapperエラーの HRESULT を持つクラス。Initializes a new instance of the ErrorWrapper class with the HRESULT of the error.

ErrorWrapper(Object) ErrorWrapper(Object) ErrorWrapper(Object) ErrorWrapper(Object)

新しいインスタンスを初期化、ErrorWrapperエラーの HRESULT を格納するオブジェクトを持つクラス。Initializes a new instance of the ErrorWrapper class with an object containing the HRESULT of the error.

プロパティ

ErrorCode ErrorCode ErrorCode ErrorCode

ラッパーのエラー コードを取得します。Gets the error code of the wrapper.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象