Marshal.PtrToStringBSTR-Methode: (IntPtr)

  • Artikel

 

Veröffentlicht: August 2016

Reserviert einen verwalteten String und kopiert eine binary string (BSTR) im nicht verwalteten Speicher hinein.

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

Syntax

[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

Parameter

  • ptr
    Type: System.IntPtr

    Die Adresse des ersten Zeichens der nicht verwalteten Zeichenfolge.

Rückgabewert

Type: System.String

Eine verwaltete Zeichenfolge, die eine Kopie der nicht verwalteten Zeichenfolge enthält.

Ausnahmen

Exception Condition
ArgumentNullException

ptr ist gleich IntPtr.Zero.

Hinweise

Rufen Sie diese Methode nur für Zeichenfolgen, die zugewiesen wurden mit der nicht verwalteten SysAllocString und SysAllocStringLen Funktionen.

PtrToStringBSTReignet sich für das Marshalling von benutzerdefinierten oder beim Kombinieren von verwaltetem und nicht verwaltetem Code. Da diese Methode eine Kopie des Inhalts der nicht verwalteten Zeichenfolge erstellt wird, müssen Sie die ursprüngliche Zeichenfolge nach Bedarf freigeben. Diese Methode stellt die Umkehrfunktion von der Marshal.StringToBSTR Methode.

Sicherheit

SecurityCriticalAttribute

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

Versionsinformationen

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone
Verfügbar seit 8.1

Siehe auch

StringToBSTR
Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang