Marshal.SecureStringToBSTR(SecureString) Méthode

Référence

Définition

Espace de noms:: System.Runtime.InteropServices

Assemblys:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Marshal.cs

Source:: Marshal.cs

Source:: Marshal.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Important

Cette API n’est pas conforme CLS.

Alloue une chaîne binaire (BSTR) non managée et y copie le contenu d’un objet SecureString managé.

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

Paramètres

s: SecureString

Objet managé à copier.

Retours

IntPtr

Adresse, dans la mémoire non managée, où le paramètre s a été copié, ou 0 si un objet null a été fourni.

Attributs: CLSCompliantAttribute SecurityCriticalAttribute

Exceptions

ArgumentNullException

Le paramètre s a la valeur null.

OutOfMemoryException

Il n’y a pas suffisamment de mémoire disponible.

Remarques

La SecureStringToBSTR méthode est utile pour le marshaling personnalisé ou lors de la combinaison de code managé et non managé. Étant donné que cette méthode alloue la mémoire non managée requise pour une chaîne, libérez toujours le BSTR lorsque vous avez terminé en appelant la ZeroFreeBSTR méthode .

S’applique à

Produit	Versions
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Partager via