Marshal.StringToCoTaskMemAnsi(String) Метод

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Исходный код:

Marshal.cs

Копирует содержимое управляемого объекта типа String в блок памяти, выделенный из неуправляемого распределителя памяти для COM-задач.

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

public static IntPtr StringToCoTaskMemAnsi (string? s);

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Параметры

s

String

Копируемая управляемая строка.

Возвращаемое значение

IntPtr

nativeint

Целое число, представляющее указатель на блок памяти, выделенный для строки, или значение 0, если строка s имеет значение null.

Исключения

OutOfMemoryException

Не хватает памяти.

ArgumentOutOfRangeException

Параметр s превышает максимальную длину, разрешенную операционной системой.

Комментарии

StringToCoTaskMemAnsi полезно для пользовательского маршалинга или при смешивании управляемого и неуправляемого кода. Так как этот метод выделяет неуправляемую память, необходимую для строки, всегда освобождайте память, вызывая .FreeCoTaskMem Этот метод предоставляет функциональность, противоположную Marshal.PtrToStringAnsi. Символы строки копируются как символы ANSI.

См. также раздел

• FreeCoTaskMem(IntPtr)
• PtrToStringAnsi(IntPtr)