Marshal.StringToBSTR-Methode: (String)

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

Ordnet eine BSTR und kopiert den Inhalt eines verwalteten String hinein.

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

Syntax

[SecurityCriticalAttribute]
public static IntPtr StringToBSTR(
    string s
)

public:
[SecurityCriticalAttribute]
static IntPtr StringToBSTR(
    String^ s
)

[<SecurityCriticalAttribute>]
static member StringToBSTR : 
        s:string -> nativeint

<SecurityCriticalAttribute>
Public Shared Function StringToBSTR (
    s As String
) As IntPtr

Parameter

s
Type: System.String

Die zu kopierende verwaltete Zeichenfolge.

Rückgabewert

Type: System.IntPtr

Ein nicht verwalteter Zeiger auf das BSTR oder 0, wenn s NULL ist.

Ausnahmen

Exception	Condition
OutOfMemoryException	Es ist nicht genügend Arbeitsspeicher verfügbar.
ArgumentOutOfRangeException	Die Länge für s liegt außerhalb des Bereichs.

Hinweise

StringToBSTR ist hilfreich beim benutzerdefinierten Marshalling und beim Kombinieren von verwaltetem und nicht verwaltetem Code. Immer freigeben, da diese Methode den nicht verwalteten Speicher für eine Zeichenfolge erforderlich reserviert, die BSTR Beendigung durch Aufrufen von Marshal.FreeBSTR. Diese Methode stellt die Umkehrfunktionen der Marshal.PtrToStringBSTR.

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

PtrToStringBSTR
FreeBSTR
Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang

Freigeben über