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

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

Marshal.StringToCoTaskMemAnsi メソッド

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

Public Shared Function StringToCoTaskMemAnsi
 ( _
    s As String _
) As IntPtr

Dim s As String
Dim returnValue As IntPtr

returnValue = Marshal.StringToCoTaskMemAnsi(s)

public static IntPtr StringToCoTaskMemAnsi
 (
    string s
)

public:
static IntPtr StringToCoTaskMemAnsi (
    String^ s
)

public static IntPtr StringToCoTaskMemAnsi
 (
    String s
)

public static function StringToCoTaskMemAnsi
 (
    s : String
) : IntPtr

戻り値
文字列に割り当てられたメモリブロックへのポインタを表す整数。null 文字列が提供された場合は 0。

例外の種類	条件
OutOfMemoryException	使用できるメモリが不足しています。
ArgumentOutOfRangeException	s パラメータがオペレーティングシステムで許可されている最大長を超えています。

StringToCoTaskMemAnsi は、カスタムマーシャリングを実行するとき、またはマネージコードとアンマネージコードを混在させるときに使用します。このメソッドは文字列で必要とされるアンマネージメモリを割り当てるため、必ず FreeCoTaskMem を呼び出すことによってメモリを解放してください。このメソッドは、Marshal.PtrToStringAnsi と反対の機能を提供します。文字列の文字は、ANSI 文字としてコピーされます。

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