Udostępnij za pośrednictwem


Marshal.StringToCoTaskMemAnsi(String) Metoda

Definicja

Kopiuje zawartość zarządzanego String bloku pamięci przydzielonej z niezarządzanego alokatora zadań COM.

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

Parametry

s
String

Zarządzany ciąg do skopiowania.

Zwraca

IntPtr

nativeint

Liczba całkowita reprezentująca wskaźnik do bloku pamięci przydzielonej dla ciągu lub 0, jeśli s jest to null.

Atrybuty

Wyjątki

Za mało dostępnej pamięci.

Parametr s przekracza maksymalną długość dozwoloną przez system operacyjny.

Uwagi

StringToCoTaskMemAnsi jest przydatne w przypadku niestandardowego marshalingu lub podczas mieszania zarządzanego i niezarządzanych kodu. Ponieważ ta metoda przydziela niezarządzaną pamięć wymaganą dla ciągu, zawsze zwalnia pamięć przez wywołanie metody FreeCoTaskMem. Ta metoda zapewnia odwrotną funkcjonalność programu Marshal.PtrToStringAnsi. Znaki ciągu są kopiowane jako znaki ANSI.

Dotyczy

Zobacz też