System.Runtime.InteropServices.Marshal.PtrToStringAuto Method

Allocates a managed string and copies the specified number of characters from a string stored in unmanaged memory into it.

Syntax

public static string PtrToStringAuto (IntPtr ptr, int len)

Parameters

ptr
For Unicode platforms, the address of the first Unicode character.
len
The number of characters to copy.

Returns

A managed string that holds a copy of the native string if the value of the ptr parameter is not null; otherwise, this method returns null.

Remarks

On Unicode platforms, this method calls Marshal.PtrToStringUni(IntPtr, int); on ANSI platforms, it calls Marshal.PtrToStringAnsi(IntPtr). No transformations are done before these methods are called.

Marshal.PtrToStringAuto(IntPtr, int) is useful for custom marshaling or when mixing managed and unmanaged code. Because this method creates a copy of the unmanaged string's contents, you must free the original string as appropriate. Marshal.PtrToStringAuto(IntPtr) provides the opposite functionality of Marshal.StringToCoTaskMemAuto(string) and Marshal.StringToHGlobalAuto(string).

Requirements

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