Marshal.StringToCoTaskMemAnsi(String) Méthode

Référence

Définition

Espace de noms:: System.Runtime.InteropServices

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.

Copie le contenu d'un String managé dans un bloc de mémoire alloué à partir de l'allocateur de tâche COM non managé.

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

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

public static IntPtr StringToCoTaskMemAnsi (string? s);

public static IntPtr StringToCoTaskMemAnsi (string s);

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

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Paramètres

s: String

Chaîne managée à copier.

Retours

IntPtr

nativeint

Entier représentant un pointeur vers le bloc de mémoire alloué pour la chaîne, ou 0 si s est null.

Attributs: SecurityCriticalAttribute

Exceptions

OutOfMemoryException

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

ArgumentOutOfRangeException

Le paramètre s dépasse la longueur maximale autorisée par le système d'exploitation.

Remarques

StringToCoTaskMemAnsi 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 la mémoire en appelant FreeCoTaskMem. Cette méthode fournit la fonctionnalité inverse de Marshal.PtrToStringAnsi. Les caractères de la chaîne sont copiés en tant que caractères ANSI.

S’applique à