Marshal.StringToCoTaskMemAnsi(String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.InteropServices

Zestaw:: System.Runtime.InteropServices.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: Marshal.cs

Źródło:: Marshal.cs

Źródło:: Marshal.cs

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 -> 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: SecurityCriticalAttribute

Wyjątki

OutOfMemoryException

Za mało dostępnej pamięci.

ArgumentOutOfRangeException

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