指定した COM オブジェクトに、指定したキーで参照するデータを設定します。
Public Shared Function SetComObjectData( _
ByVal obj As Object, _ ByVal key As Object, _ ByVal data As Object _) As Boolean
[C#]
public static bool SetComObjectData(objectobj,objectkey,objectdata);
[C++]
public: static bool SetComObjectData(Object* obj,Object* key,Object* data);
[JScript]
public static function SetComObjectData(
obj : Object,key : Object,data : Object) : Boolean;
パラメータ
- obj
データを格納する COM オブジェクト。 - key
データを格納する COM オブジェクトの内部ハッシュ テーブルにあるキー。 - data
設定するデータ。
戻り値
データが正常に設定された場合は true 。それ以外の場合は false 。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | obj が null 参照 (Visual Basic では Nothing) です。
または key が null 参照 (Nothing) です。 |
ArgumentException | obj が COM オブジェクトではありません。 |
解説
ランタイム呼び出し可能ラッパーでラップされたすべての COM オブジェクトには、ハッシュ テーブルが関連付けられます。 SetComObjectData はこのハッシュ テーブルにデータを追加します。また、 Marshal.GetComObjectData はこのハッシュ テーブルからデータを取り出します。どちらのメソッドもコードの中で直接使用することはありません。
メモ このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。 SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。 LinkDemand メンバの使用に関する重要な制約事項については、「 Demand と LinkDemand 」を参照してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
参照
Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | GetComObjectData