Freigeben über

Marshal.StringToBSTR-Methode

Reserviert einen BSTR und kopiert den Inhalt eines verwalteten String hinein.

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

Syntax

'Declaration
Public Shared Function StringToBSTR ( _
    s As String _
) As IntPtr
'Usage
Dim s As String
Dim returnValue As IntPtr

returnValue = Marshal.StringToBSTR(s)

public static IntPtr StringToBSTR (
    string s
)

public:
static IntPtr StringToBSTR (
    String^ s
)

public static IntPtr StringToBSTR (
    String s
)

public static function StringToBSTR (
    s : String
) : IntPtr

Parameter

  • s
    Die zu kopierende verwaltete Zeichenfolge.

Rückgabewert

Ein nicht verwalteter Zeiger auf den BSTR oder 0 (null), wenn eine NULL-Zeichenfolge bereitgestellt wurde.

Ausnahmen

Ausnahmetyp Bedingung

OutOfMemoryException

Es ist nicht genügend Speicherplatz vorhanden.

Hinweise

StringToBSTR ist hilfreich beim benutzerdefinierten Marshalling und beim Kombinieren von verwaltetem und nicht verwaltetem Code. Da diese Methode den erforderlichen nicht verwalteten Speicher für eine Zeichenfolge reserviert, müssen Sie den BSTR nach der Fertigstellung immer freigeben, indem Sie Marshal.FreeBSTR aufrufen. Diese Methode stellt die Umkehrfunktion von Marshal.PtrToStringBSTR bereit.

Hinweis

Diese Methode verwendet SecurityAction.LinkDemand, um einen Aufruf aus nicht vertrauenswürdigem Code zu verhindern. Nur der direkte Aufrufer muss über die SecurityPermissionAttribute.UnmanagedCode-Berechtigung verfügen. Wenn der Code aus teilweise vertrauenswürdigem Code aufgerufen werden kann, dürfen Benutzereingaben nicht ohne Validierung an Methoden der Marshal-Klasse übergeben werden. Wichtige Einschränkungen bei der Verwendung des LinkDemand-Members finden Sie unter "Demand" und "LinkDemand".

.NET Framework-Sicherheit

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

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

  • Last updated on