Marshal.StringToCoTaskMemUni(String) Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

Marshal.cs

Copia o conteúdo de um String gerenciado para um bloco de memória alocado do alocador de tarefas COM não gerenciado.

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

Uma cadeia de caracteres gerenciada a ser copiada.

Retornos

IntPtr

nativeint

Um inteiro que representa um ponteiro para o bloco de memória alocado na cadeia de caracteres ou 0, se s for null.

Exceções

ArgumentOutOfRangeException

O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.

OutOfMemoryException

Memória insuficiente.

Comentários

StringToCoTaskMemUni é útil para marshaling personalizado ou para uso ao misturar código gerenciado e não gerenciado. Como esse método aloca a memória não gerenciada necessária para uma cadeia de caracteres, sempre libere a memória chamando Marshal.FreeCoTaskMem. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringUni. Os caracteres da cadeia de caracteres são copiados como caracteres Unicode.

Essa API reflete a definição do Windows de Unicode, que é uma codificação UTF-16 de 2 bytes. Em muitas plataformas não Windows, o wchar_t tipo de dados é de 4 bytes, não de 2 bytes. Consulte o compilador para confirmar se wchar_t pode ser usado ou char16_t deve ser usado.

Confira também

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