Marshal.StringToCoTaskMemAnsi(String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyalin konten yang dikelola String ke blok memori yang dialokasikan dari alokator tugas COM yang tidak dikelola.
public:
static IntPtr StringToCoTaskMemAnsi(System::String ^ s);
[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemAnsi (string s);
public static IntPtr StringToCoTaskMemAnsi (string? s);
public static IntPtr StringToCoTaskMemAnsi (string s);
[<System.Security.SecurityCritical>]
static member StringToCoTaskMemAnsi : string -> nativeint
static member StringToCoTaskMemAnsi : string -> nativeint
Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr
Parameter
- s
- String
String terkelola yang akan disalin.
Mengembalikan
nativeint
Bilangan bulat yang mewakili pointer ke blok memori yang dialokasikan untuk string, atau 0 jika s
adalah null
.
- Atribut
Pengecualian
Tidak tersedia cukup memori.
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.