Marshal.StringToCoTaskMemAnsi(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Копирует содержимое управляемого объекта типа String в блок памяти, выделенный из неуправляемого распределителя памяти для 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 IntPtrПараметры
- s
- String
Копируемая управляемая строка.
Возвращаемое значение
nativeint
Целое число, представляющее указатель на блок памяти, выделенный для строки, или значение 0, если строка s имеет значение null.
- Атрибуты
Исключения
Не хватает памяти.
Параметр s превышает максимальную длину, разрешенную операционной системой.
Комментарии
StringToCoTaskMemAnsi полезно для пользовательского маршалинга или при смешении управляемого и неуправляемого кода. Так как этот метод выделяет неуправляемую память, необходимую для строки, всегда освобождайте память путем вызова FreeCoTaskMem. Этот метод предоставляет противоположные функциональные возможности Marshal.PtrToStringAnsi. Символы строки копируются как символы ANSI.
