Marshal.StringToCoTaskMemAnsi(String) Метод

Определение

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

System.Runtime.InteropServices

Сборки:

netstandard.dll, 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)