Marshal.StringToCoTaskMemAnsi(String) Метод

Определение

Копирует содержимое управляемого объекта типа String в блок памяти, выделенный из неуправляемого распределителя памяти для COM-задач.Copies the contents of a managed String to a block of memory allocated from the unmanaged COM task allocator.

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 -> nativeint
static member StringToCoTaskMemAnsi : string -> nativeint
Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Параметры

s
String

Копируемая управляемая строка.A managed string to be copied.

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

IntPtr

Целое число, представляющее указатель на блок памяти, выделенный для строки, или значение 0, если строка s имеет значение null.An integer representing a pointer to the block of memory allocated for the string, or 0 if s is null.

Атрибуты

Исключения

Не хватает памяти.There is insufficient memory available.

Параметр s превышает максимальную длину, разрешенную операционной системой.The s parameter exceeds the maximum length allowed by the operating system.

Комментарии

StringToCoTaskMemAnsi полезен при пользовательском упаковке или при смешении управляемого и неуправляемого кода.StringToCoTaskMemAnsi is useful for custom marshaling or when mixing managed and unmanaged code. Поскольку этот метод выделяет неуправляемую память, необходимую для строки, всегда освобождайте память путем вызова FreeCoTaskMem .Because this method allocates the unmanaged memory required for a string, always free the memory by calling FreeCoTaskMem. Этот метод обеспечивает обратную функциональность Marshal.PtrToStringAnsi .This method provides the opposite functionality of Marshal.PtrToStringAnsi. Символы строки копируются как символы ANSI.The characters of the string are copied as ANSI characters.

Применяется к

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