Marshal.PtrToStringBSTR(IntPtr) Método

Definição

Namespace:

System.Runtime.InteropServices

Assemblies:

netstandard.dll, System.Runtime.InteropServices.dll

Origem:

Marshal.cs

Aloca uma BSTR (cadeia de caracteres binária gerenciada) armazenada na memória não gerenciada nela.

public:
 static System::String ^ PtrToStringBSTR(IntPtr ptr);

public static string PtrToStringBSTR(IntPtr ptr);

static member PtrToStringBSTR : nativeint -> string

Public Shared Function PtrToStringBSTR (ptr As IntPtr) As String

Parâmetros

ptr

IntPtr

nativeint

O endereço do primeiro caractere da cadeia de caracteres não gerenciada.

Retornos

String

Uma cadeia de caracteres gerenciada que contém uma cópia da cadeia de caracteres não gerenciada.

Exceções

ArgumentNullException

ptr igual a Zero.

Comentários

Chame esse método apenas em cadeias de caracteres que foram alocadas com as funções SysAllocString e SysAllocStringLen não gerenciadas.

PtrToStringBSTR é útil para marshaling personalizado ou ao misturar código gerenciado e não gerenciado. Como esse método cria uma cópia do conteúdo da cadeia de caracteres não gerenciada, você deve liberar a cadeia de caracteres original conforme apropriado. Esse método fornece a funcionalidade oposta do Marshal.StringToBSTR método.

Confira também

• StringToBSTR(String)