Marshal.PtrToStringBSTR(IntPtr) Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

Marshal.cs

Aloca um String gerenciado e copia para ele uma BSTR (cadeia de caracteres binária) armazenada na memória não gerenciada.

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 somente 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)