Marshal.StringToBSTR(String) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

netstandard.dll, System.Runtime.InteropServices.dll

Sumber:

Marshal.cs

Mengalokasikan BSTR dan menyalin konten yang dikelola String ke dalamnya.

public:
 static IntPtr StringToBSTR(System::String ^ s);

public static IntPtr StringToBSTR(string? s);

static member StringToBSTR : string -> nativeint

Public Shared Function StringToBSTR (s As String) As IntPtr

Parameter

s

String

String terkelola yang akan disalin.

Mengembalikan

IntPtr

nativeint

Penunjuk yang tidak dikelola ke BSTR, atau 0 jika s null.

Pengecualian

OutOfMemoryException

Memori tidak tersedia cukup.

ArgumentOutOfRangeException

Panjang untuk s berada di luar jangkauan.

Keterangan

StringToBSTR berguna untuk marshaling kustom atau saat mencampur kode terkelola dan tidak terkelola. Karena metode ini mengalokasikan memori yang tidak dikelola yang diperlukan untuk string, selalu bebaskan BSTR ketika selesai dengan memanggil Marshal.FreeBSTR. Metode ini menyediakan fungsionalitas yang berlawanan dari Marshal.PtrToStringBSTR.

Lihat juga

• PtrToStringBSTR(IntPtr)
• FreeBSTR(IntPtr)