Marshal.StringToBSTR(String) Méthode

Référence

Définition

Espace de noms:: System.Runtime.InteropServices

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

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.

Alloue une chaîne BSTR pour y copier le contenu d’un String managé.

public:
 static IntPtr StringToBSTR(System::String ^ s);

[System.Security.SecurityCritical]
public static IntPtr StringToBSTR(string s);

public static IntPtr StringToBSTR(string? s);

public static IntPtr StringToBSTR(string s);

[<System.Security.SecurityCritical>]
static member StringToBSTR : string -> nativeint

static member StringToBSTR : string -> nativeint

Public Shared Function StringToBSTR (s As String) As IntPtr

Paramètres

s: String

Chaîne managée à copier.

Retours

IntPtr

Pointeur non managé vers le BSTR ou 0 si s a la valeur null.

Attributs: SecurityCriticalAttribute

Exceptions

OutOfMemoryException

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

ArgumentOutOfRangeException

La longueur de s est hors limites.

Remarques

StringToBSTR est utile pour le marshaling personnalisé ou lors du mélange 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 quand vous avez terminé en appelant Marshal.FreeBSTR. Cette méthode fournit la fonctionnalité inverse de Marshal.PtrToStringBSTR.

S’applique à

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 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	1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Partager via