Marshal::PtrToStringUni Method (IntPtr)

.NET Framework (current version)

Allocates a managed String and copies all characters up to the first null character from an unmanaged Unicode string into it.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

public:
[SecurityCriticalAttribute]
static String^ PtrToStringUni(
	IntPtr ptr
)

Parameters

ptr: Type: System::IntPtr
The address of the first character of the unmanaged string.

Return Value

Type: System::String^

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

PtrToStringUni is useful for custom marshaling or for use 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. This method provides the opposite functionality of the Marshal::StringToCoTaskMemUni and Marshal::StringToHGlobalUni methods.

Security

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1