Marshal.StringToBSTR(String) メソッド

定義

BSTR を割り当て、それにマネージド String の内容をコピーします。

C#
[System.Security.SecurityCritical]
public static IntPtr StringToBSTR(string s);
C#
public static IntPtr StringToBSTR(string? s);
C#
public static IntPtr StringToBSTR(string s);

パラメーター

s
String

コピーするマネージド文字列。

戻り値

IntPtr

BSTR へのアンマネージ ポインター。s が null の場合は 0。

属性

例外

使用できるメモリが不足しています。

s の長さが範囲外です。

注釈

StringToBSTR は、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在させる場合に便利です。 このメソッドは文字列に必要なアンマネージ メモリを割り当てるので、 を呼び出Marshal.FreeBSTRして終了したら常に をBSTR解放します。 このメソッドは、 の逆の機能を Marshal.PtrToStringBSTR提供します。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください