Marshal.StringToCoTaskMemAnsi(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> nativeintstatic member StringToCoTaskMemAnsi : string -> nativeintPublic Shared Function StringToCoTaskMemAnsi (s As String) As IntPtrParametry
- s
- String
Zarządzany ciąg do skopiowania.
Zwraca
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.
