Marshal.StringToCoTaskMemUni(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Копирует содержимое управляемого объекта типа String в блок памяти, выделенный из неуправляемого распределителя памяти для COM-задач.
public:
static IntPtr StringToCoTaskMemUni(System::String ^ s);[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemUni (string s);public static IntPtr StringToCoTaskMemUni (string? s);public static IntPtr StringToCoTaskMemUni (string s);[<System.Security.SecurityCritical>]
static member StringToCoTaskMemUni : string -> nativeintstatic member StringToCoTaskMemUni : string -> nativeintPublic Shared Function StringToCoTaskMemUni (s As String) As IntPtrПараметры
- s
- String
Копируемая управляемая строка.
Возвращаемое значение
-
IntPtr
nativeint
Целое число, представляющее указатель на блок памяти, выделенный для строки, или значение 0, если строка s имеет значение null.
- Атрибуты
Исключения
Параметр s превышает максимальную длину, разрешенную операционной системой.
Не хватает памяти.
Комментарии
StringToCoTaskMemUni используется для пользовательского маршалинга или использования при смешивании управляемого и неуправляемого кода. Так как этот метод выделяет неуправляемую память, необходимую для строки, всегда освобождает память путем вызова Marshal.FreeCoTaskMem. Этот метод предоставляет противоположные функциональные возможности Marshal.PtrToStringUni. Символы строки копируются как символы Юникода.
Этот API отражает определение Windows Юникода, которое является кодировкой UTF-16 2-байтов. На многих платформах, отличных от Windows, wchar_t тип данных составляет 4 байта, а не 2 байта. Обратитесь к компилятору, чтобы проверить, можно ли wchar_t использовать или char16_t использовать его.