Marshal.StringToCoTaskMemAnsi(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アンマネージド COM タスク アロケーターから割り当てられたメモリ ブロックに、マネージド String の内容をコピーします。
public:
static IntPtr StringToCoTaskMemAnsi(System::String ^ s);
[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemAnsi(string s);
public static IntPtr StringToCoTaskMemAnsi(string? s);
public static IntPtr StringToCoTaskMemAnsi(string s);
[<System.Security.SecurityCritical>]
static member StringToCoTaskMemAnsi : string -> nativeint
static member StringToCoTaskMemAnsi : string -> nativeint
Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr
パラメーター
- s
- String
コピーされるマネージド文字列。
戻り値
nativeint
文字列に割り当てられたメモリ ブロックへのポインターを表す整数。s
が null
の場合は 0。
- 属性
例外
使用できるメモリが不足しています。
s
パラメーターがオペレーティング システムで許可されている最大長を超えています。
注釈
StringToCoTaskMemAnsi は、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在させる場合に便利です。 このメソッドは、文字列に必要なアンマネージ メモリを割り当てるので、 を呼び出 FreeCoTaskMemして常にメモリを解放します。 このメソッドは、 の逆の機能を Marshal.PtrToStringAnsi提供します。 文字列の文字は ANSI 文字としてコピーされます。