Marshal.StringToCoTaskMemAnsi(String) Метод
Определение
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
Копируемая управляемая строка.A managed string to be copied.
Возвращаемое значение
Целое число, представляющее указатель на блок памяти, выделенный для строки, или значение 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.