Share via

Marshal.AllocCoTaskMem メソッド

  • [アーティクル]

COM タスク メモリ アロケータから、指定したサイズのメモリ ブロックを割り当てます。

Public Shared Function AllocCoTaskMem( _
   ByVal cb As Integer _) As IntPtr
[C#]
public static IntPtr AllocCoTaskMem(intcb);
[C++]
public: static IntPtr AllocCoTaskMem(intcb);
[JScript]
public static function AllocCoTaskMem(
   cb : int) : IntPtr;

パラメータ

  • cb
    割り当てるメモリ ブロックのサイズ。

戻り値

割り当てられたメモリ ブロックのアドレスを表す整数。このメモリは、 Marshal.FreeCoTaskMem を使用して解放する必要があります。

例外

例外の種類 条件
OutOfMemoryException 要求を満たすにはメモリが不足しています。

解説

Marshal クラスにはメモリ割り当て API メソッドが 2 つ用意されていますが、 AllocCoTaskMem はその 1 つです。( なお、もう 1 つは Marshal.AllocHGlobal です。返される最初のメモリのデータは未定義で、割り当てられたメモリは要求したバイト数より多いこともあります。このメソッドは CoTaskMemAlloc COM API メソッド (COM タスク メモリ アロケータ) を公開します。 CoTaskMemAlloc の詳細については、MSDN ライブラリを参照してください。

メモ   このメソッドは 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 セキュリティ:

参照

Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | AllocHGlobal | FreeCoTaskMem