Marshal.WriteIntPtr メソッド (IntPtr, Int32, IntPtr)

アンマネージ メモリにプロセッサ ネイティブ サイズの整数を書き込みます。

Overloads Public Shared Sub WriteIntPtr( _
   ByVal ptr As IntPtr, _   ByVal ofs As Integer, _   ByVal val As IntPtr _)
[C#]
public static void WriteIntPtr(IntPtrptr,intofs,IntPtrval);
[C++]
public: static void WriteIntPtr(IntPtrptr,intofs,IntPtrval);
[JScript]
public static function WriteIntPtr(
   ptr : IntPtr,ofs : int,val : IntPtr);

パラメータ

• ptr
  書き込み元となるアンマネージ メモリ内のベース アドレス。
• ofs
  書き込む前に ptr パラメータに追加された、追加のバイト オフセット。
• val
  書き込む値。

例外

例外の種類	条件
ArgumentException	ptr が認識された形式ではありません。

解説

WriteIntPtr を使用すると、C スタイル IntPtr のアンマネージ配列を直接操作できます。このとき、要素の値を設定する前にアンマネージ配列全体を (Marshal.Copy を使用して) 別のマネージ配列にコピーする必要はありません。

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

使用例

[Visual Basic, C#] C スタイル IntPtr のアンマネージ配列と対話する 2 つの方法を比較する例を次に示します。 WriteIntPtr メソッドを使用すると、配列の要素の値に直接アクセスでき、その 10 の要素に値 1 ～ 10 を設定します。

 
Dim unmanagedArray As IntPtr = ...
Dim i As Integer
' One way to set the 10 elements of the C-style unmanagedArray
Dim newArray As IntPtr(9)
Marshal.Copy(unmanagedArray, newArray, 0, 10)
For i = 0 To newArray.Length
  newArray(i) = i+1
Next i
Marshal.Copy(newArray, 0, unmanagedArray, 10)
' Another way to set the 10 elements of the C-style unmanagedArray
For i = 0 To 10
  Marshal.WriteIntPtr(unmanagedArray, i, i+1)
Next i
      
[C#] 
IntPtr unmanagedArray = ...;
// One way to set the 10 elements of the C-style unmanagedArray
byte [] newArray = new IntPtr[10];
Marshal.Copy(unmanagedArray, newArray, 0, 10);
for (int i = 0; i < newArray.Length; i++)
  newArray[i] = i+1;
Marshal.Copy(newArray, 0, unmanagedArray, 10);
// Another way to set the 10 elements of the C-style unmanagedArray
for (int i = 0; i < 10; i++)
  Marshal.WriteIntPtr(unmanagedArray, i, i+1);
      

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: 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 名前空間 | Marshal.WriteIntPtr オーバーロードの一覧 | Copy | WriteByte