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