Marshal.SecureStringToBSTR-Methode: (SecureString)

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

Weist eine nicht verwaltete binary string (BSTR) und kopiert den Inhalt eines verwalteten SecureString in dieses Objekt.

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

Syntax

[SecurityCriticalAttribute]
public static IntPtr SecureStringToBSTR(
    SecureString s
)

public:
[SecurityCriticalAttribute]
static IntPtr SecureStringToBSTR(
    SecureString^ s
)

[<SecurityCriticalAttribute>]
static member SecureStringToBSTR : 
        s:SecureString -> nativeint

<SecurityCriticalAttribute>
Public Shared Function SecureStringToBSTR (
    s As SecureString
) As IntPtr

Parameter

s
Type: System.Security.SecureString

Das zu kopierende verwaltete Objekt.

Rückgabewert

Type: System.IntPtr

Die Adresse im nicht verwalteten Speicher, in die der s-Parameter kopiert wurde, oder 0, wenn ein NULL-Objekt bereitgestellt wurde.

Ausnahmen

Exception	Condition
ArgumentNullException	Der s-Parameter ist null.
NotSupportedException	Auf dem aktuellen Computer wird nicht Windows 2000 Service Pack 3 oder höher ausgeführt.
OutOfMemoryException	Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Die SecureStringToBSTR Methode ist hilfreich beim benutzerdefinierten Marshalling oder 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 der ZeroFreeBSTR Methode.

Hinweise für Aufrufer:

Diese Methode ist nur auf Computern unter Windows 2000 Service Pack 3 oder höher unterstützt.

Sicherheit

SecurityCriticalAttribute

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

Versionsinformationen

.NET Framework
Verfügbar seit 2.0

Siehe auch

Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang

Freigeben über