Marshal.StringToCoTaskMemUni(String) Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Source:

Marshal.cs

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

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

public static IntPtr StringToCoTaskMemUni (string? s);

static member StringToCoTaskMemUni : string -> nativeint

Public Shared Function StringToCoTaskMemUni (s As String) As IntPtr

Parámetros

s

String

Cadena administrada que se va a copiar.

Devoluciones

IntPtr

nativeint

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

Excepciones

ArgumentOutOfRangeException

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

OutOfMemoryException

No hay suficiente memoria disponible.

Comentarios

StringToCoTaskMemUni es útil para la serialización personalizada o para su uso 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 Marshal.FreeCoTaskMem. Este método proporciona la funcionalidad opuesta de Marshal.PtrToStringUni. Los caracteres de la cadena se copian como caracteres Unicode.

Esta API refleja la definición de Windows de Unicode, que es una codificación de 2 bytes UTF-16. En muchas plataformas que no son de Windows, el wchar_t tipo de datos es de 4 bytes, no de 2 bytes. Consulte al compilador para confirmar si wchar_t se puede usar o char16_t se debe usar en su lugar.

Consulte también

• FreeCoTaskMem(IntPtr)
• PtrToStringUni(IntPtr, Int32)