Marshal.GetObjectsForNativeVariants メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Marshal.GetObjectsForNativeVariants メソッド

COM VARIANT の配列をオブジェクトの配列に変換します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetObjectsForNativeVariants
 ( _
    aSrcNativeVariant As IntPtr, _
    cVars As Integer _
) As Object()

Visual Basic (使用法)

Dim aSrcNativeVariant As IntPtr
Dim cVars As Integer
Dim returnValue As Object()

returnValue = Marshal.GetObjectsForNativeVariants(aSrcNativeVariant, cVars)

public static Object[] GetObjectsForNativeVariants
 (
    IntPtr aSrcNativeVariant,
    int cVars
)

C++

public:
static array<Object^>^ GetObjectsForNativeVariants (
    IntPtr aSrcNativeVariant, 
    int cVars
)

public static Object[] GetObjectsForNativeVariants
 (
    IntPtr aSrcNativeVariant, 
    int cVars
)

JScript

public static function GetObjectsForNativeVariants
 (
    aSrcNativeVariant : IntPtr, 
    cVars : int
) : Object[]

パラメータ

aSrcNativeVariant: COM VARIANT の配列の最初の要素を格納している IntPtr。

cVars: aSrcNativeVariant 内の COM VARIANT の数。

戻り値
aSrcNativeVariant に対応するオブジェクト配列。

例外

例外の種類	条件
ArgumentOutOfRangeException	cVars を負の値にすることはできません。

解説

GetObjectsForNativeVariants は、アンマネージ VARIANT 型の C スタイル配列への生のポインタに対応するマネージオブジェクトの配列を返します。相互運用マーシャラは、VARIANT 型をマネージコードに公開するとき、まったく同じ変換を実行します。cVars パラメータが 0 の場合、このメソッドは空の配列を返します。

メモ
このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。