Compartilhar via


Marshal.PtrToStringBSTR(IntPtr) Método

Definição

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);
[System.Security.SecurityCritical]
public static string PtrToStringBSTR (IntPtr ptr);
public static string PtrToStringBSTR (IntPtr ptr);
[<System.Security.SecurityCritical>]
static member PtrToStringBSTR : nativeint -> string
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

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

Atributos

Exceções

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 .

Aplica-se a

Confira também