Marshal.StringToCoTaskMemUni(String) Metoda

Definicja

Przestrzeń nazw:

System.Runtime.InteropServices

Zestaw:

System.Runtime.InteropServices.dll

Źródło:

Marshal.cs

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

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

public static IntPtr StringToCoTaskMemUni (string? s);

static member StringToCoTaskMemUni : string -> nativeint

Public Shared Function StringToCoTaskMemUni (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 wartość s to null.

Wyjątki

ArgumentOutOfRangeException

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

OutOfMemoryException

Za mało dostępnej pamięci.

Uwagi

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

Ten interfejs API odzwierciedla definicję systemu Windows unicode, która jest kodowaniem utF-16 2-bajtowym. Na wielu platformach wchar_t innych niż Windows typ danych to 4 bajty, a nie 2 bajty. Skonsultuj się z kompilatorem, aby potwierdzić, czy wchar_t można go użyć lub char16_t zamiast tego należy go użyć.

Zobacz też

• FreeCoTaskMem(IntPtr)
• PtrToStringUni(IntPtr, Int32)