Copies the contents of a managed
String into unmanaged memory, converting into ANSI format as it copies.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Visual Basic (Declaration)
Public Shared Function StringToHGlobalAnsi ( _
s As String _
) As IntPtr
Dim s As String
Dim returnValue As IntPtr
returnValue = Marshal.StringToHGlobalAnsi(s)
public static IntPtr StringToHGlobalAnsi (
string s
)
public:
static IntPtr StringToHGlobalAnsi (
String^ s
)
public static IntPtr StringToHGlobalAnsi (
String s
)
public static function StringToHGlobalAnsi (
s : String
) : IntPtr
Parameters
- s
A managed string to be copied.
Return Value
The address, in unmanaged memory, to where s was copied, or 0 if a null string was supplied.
StringToHGlobalAnsi is useful for custom marshaling or when mixing managed and unmanaged code. Since this method allocates the unmanaged memory required for a string, always free the memory by calling FreeHGlobal. StringToHGlobalAnsi provides the opposite functionality of Marshal.PtrToStringAnsi.
The following code example demonstrates how to convert the contents of a managed String class to unmanaged memory and then dispose of the unmanaged memory when done.
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
.NET Framework
Supported in: 2.0, 1.1, 1.0