Marshal.SecureStringToBSTR(SecureString) Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wichtig

Diese API ist nicht CLS-kompatibel.

Reserviert eine nicht verwaltete binäre Zeichenfolge (BSTR) und kopiert den Inhalt eines verwalteten SecureString-Objekts hinein.

public:
 static IntPtr SecureStringToBSTR(System::Security::SecureString ^ s);

public static IntPtr SecureStringToBSTR (System.Security.SecureString s);

[System.CLSCompliant(false)]
public static IntPtr SecureStringToBSTR (System.Security.SecureString s);

[System.Security.SecurityCritical]
public static IntPtr SecureStringToBSTR (System.Security.SecureString s);

static member SecureStringToBSTR : System.Security.SecureString -> nativeint

[<System.CLSCompliant(false)>]
static member SecureStringToBSTR : System.Security.SecureString -> nativeint

[<System.Security.SecurityCritical>]
static member SecureStringToBSTR : System.Security.SecureString -> nativeint

Public Shared Function SecureStringToBSTR (s As SecureString) As IntPtr

Parameter

s: SecureString

Das zu kopierende verwaltete Objekt.

Gibt zurück

IntPtr

nativeint

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

Attribute: CLSCompliantAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

Der s-Parameter ist null.

OutOfMemoryException

Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Die SecureStringToBSTR Methode ist nützlich für benutzerdefiniertes Marshalling oder beim Mischen von verwaltetem und nicht verwaltetem Code. Da diese Methode den nicht verwalteten Arbeitsspeicher zuweist, der für eine Zeichenfolge erforderlich ist, geben Sie immer den frei, wenn sie BSTR fertig ist, indem Sie die ZeroFreeBSTR -Methode aufrufen.

Gilt für: