Marshal.SecureStringToBSTR(SecureString) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.InteropServices

Zestaw:: System.Runtime.InteropServices.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Przydziela niezarządzany ciąg binarny (BSTR) i kopiuje do niego zawartość zarządzanego SecureString obiektu.

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

Parametry

s: SecureString

Obiekt zarządzany do skopiowania.

Zwraca

IntPtr nativeint

Adres w pamięci niezarządzanej, do której s został skopiowany parametr, lub 0, jeśli podano obiekt o wartości null.

Atrybuty: CLSCompliantAttribute SecurityCriticalAttribute

Wyjątki

ArgumentNullException

Parametr s ma wartość null.

OutOfMemoryException

Za mało dostępnej pamięci.

Uwagi

Metoda jest przydatna SecureStringToBSTR do marshalingu niestandardowego lub podczas mieszania zarządzanego i niezarządzanych kodu. Ponieważ ta metoda przydziela niezarządzaną pamięć wymaganą dla ciągu, zawsze zwalnia BSTR po zakończeniu, wywołując metodę ZeroFreeBSTR .

Dotyczy