Marshal.StringToCoTaskMemAnsi(String) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

Marshal.cs

Menyalin konten yang dikelola String ke blok memori yang dialokasikan dari alokator tugas COM yang tidak dikelola.

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

public static IntPtr StringToCoTaskMemAnsi (string? s);

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Parameter

s

String

String terkelola yang akan disalin.

Mengembalikan

IntPtr

nativeint

Bilangan bulat yang mewakili pointer ke blok memori yang dialokasikan untuk string, atau 0 jika s adalah null.

Pengecualian

OutOfMemoryException

Tidak tersedia cukup memori.

ArgumentOutOfRangeException

Parameter s melebihi panjang maksimum yang diizinkan oleh sistem operasi.

Keterangan

StringToCoTaskMemAnsi berguna untuk marshaling kustom atau saat mencampur kode yang dikelola dan tidak dikelola. Karena metode ini mengalokasikan memori tidak terkelola yang diperlukan untuk string, selalu bebaskan memori dengan memanggil FreeCoTaskMem. Metode ini menyediakan fungsionalitas yang berlawanan dari Marshal.PtrToStringAnsi. Karakter string disalin sebagai karakter ANSI.

Lihat juga

• FreeCoTaskMem(IntPtr)
• PtrToStringAnsi(IntPtr)