Método Marshal.PtrToStringBSTR (IntPtr)

Artigo
04/22/2017

Aloca um gerenciado String e copia um binary string (BSTR) armazenados em memória não gerenciada para ele.

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

Sintaxe

[SecurityCriticalAttribute]
public static string PtrToStringBSTR(
    IntPtr ptr
)

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

[<SecurityCriticalAttribute>]
static member PtrToStringBSTR : 
        ptr:nativeint -> string

<SecurityCriticalAttribute>
Public Shared Function PtrToStringBSTR (
    ptr As IntPtr
) As String

Parâmetros

ptr
Type: System.IntPtr

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

Valor Retornado

Type: System.String

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

Exceções

Exception	Condition
ArgumentNullException	ptr é igual a IntPtr.Zero.

Comentários

Chame este método somente em cadeias de caracteres que foram alocadas com não gerenciado SysAllocString e SysAllocStringLen funções.

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

Segurança

SecurityCriticalAttribute

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

Informações de Versão

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Windows Phone
Disponível desde 8.1

Confira Também

StringToBSTR
Classe Marshal
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via