Marshal.StringToHGlobalUni(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
マネージド String の内容をアンマネージド メモリにコピーします。
public:
static IntPtr StringToHGlobalUni(System::String ^ s);[System.Security.SecurityCritical]
public static IntPtr StringToHGlobalUni (string s);public static IntPtr StringToHGlobalUni (string? s);public static IntPtr StringToHGlobalUni (string s);[<System.Security.SecurityCritical>]
static member StringToHGlobalUni : string -> nativeintstatic member StringToHGlobalUni : string -> nativeintPublic Shared Function StringToHGlobalUni (s As String) As IntPtrパラメーター
- s
- String
コピーされるマネージド文字列。
戻り値
nativeint
s のコピー先となったアンマネージ メモリ内のアドレス。s が null の場合は 0。
- 属性
例外
メソッドが十分なネイティブ ヒープ メモリを割り当てることができませんでした。
s パラメーターがオペレーティング システムで許可されている最大長を超えています。
注釈
StringToHGlobalUni は、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在する場合に使用する場合に便利です。 このメソッドは文字列に必要なアンマネージ メモリを割り当てるので、 を呼び出 FreeHGlobalして常にメモリを解放します。 このメソッドは、 の逆の機能を Marshal.PtrToStringUni提供します。
このメソッドは、埋め込まれた null 文字をコピーし、終端の null 文字を含みます。
この API には、UTF-16 2 バイト エンコードである Unicode の Windows 定義が反映されています。 多くの Windows 以外のプラットフォームでは、 wchar_t データ型は 2 バイトではなく 4 バイトです。 コンパイラに問い合わせて、使用できるかどうかを確認するかchar16_t、代わりに使用する必要があるかどうかを確認wchar_tします。
適用対象
こちらもご覧ください
.NET