System.Runtime.InteropServices.Marshal.StringToCoTaskMemAnsi Method

Copies the contents of a managed string to a block of memory allocated from the unmanaged COM task allocator.

Syntax

public static IntPtr StringToCoTaskMemAnsi (string s)

Parameters

s
A managed string to be copied.

Returns

An integer representing a pointer to the block of memory allocated for the string, or 0 if s is null.

Remarks

Marshal.StringToCoTaskMemAnsi(string) is useful for custom marshaling or when mixing managed and unmanaged code. Because this method allocates the unmanaged memory required for a string, always free the memory by calling Marshal.FreeCoTaskMem(IntPtr). This method provides the opposite functionality of Marshal.PtrToStringAnsi(IntPtr). The characters of the string are copied as ANSI characters.

Requirements

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0