Marshal.PtrToStringBSTR(IntPtr) Method

Definition

Namespace:

System.Runtime.InteropServices

Assemblies:

netstandard.dll, System.Runtime.InteropServices.dll

Source:

Marshal.cs

Allocates a managed String and copies a binary string (BSTR) stored in unmanaged memory into it.

C#

public static string PtrToStringBSTR(IntPtr ptr);

Parameters

ptr

IntPtr

The address of the first character of the unmanaged string.

Returns

String

A managed string that holds a copy of the unmanaged string.

Exceptions

ArgumentNullException

ptr equals Zero.

Remarks

Call this method only on strings that were allocated with the unmanaged SysAllocString and SysAllocStringLen functions.

PtrToStringBSTR 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. This method provides the opposite functionality of the Marshal.StringToBSTR method.

Applies to

See also

• StringToBSTR(String)