Marshal.StringToCoTaskMemAnsi(String) Método

Referencia

Definición

Espacio de nombres:: System.Runtime.InteropServices

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

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

Ensamblado:: System.Runtime.InteropServices.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Source:: Marshal.cs

Source:: Marshal.cs

Source:: Marshal.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Copia el contenido de un String administrado en un bloque de memoria asignado desde el asignador de tareas COM no administrado.

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

Parámetros

s: String

Cadena administrada que se va a copiar.

Devoluciones

IntPtr

Entero que representa un puntero al bloque de memoria asignado a la cadena, o 0 si s es null.

Atributos: SecurityCriticalAttribute

Excepciones

OutOfMemoryException

No hay suficiente memoria disponible.

ArgumentOutOfRangeException

El parámetro s supera la longitud máxima permitida por el sistema operativo.

Comentarios

StringToCoTaskMemAnsi es útil para la serialización personalizada o al mezclar código administrado y no administrado. Dado que este método asigna la memoria no administrada necesaria para una cadena, libere siempre la memoria llamando a FreeCoTaskMem. Este método proporciona la funcionalidad opuesta de Marshal.PtrToStringAnsi. Los caracteres de la cadena se copian como caracteres ANSI.

Se aplica a

Produto	Versións
.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

Compartir por