Marshal.StringToCoTaskMemUTF8(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 StringToCoTaskMemUTF8(System::String ^ s);public static IntPtr StringToCoTaskMemUTF8 (string? s);[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemUTF8 (string s);public static IntPtr StringToCoTaskMemUTF8 (string s);static member StringToCoTaskMemUTF8 : string -> nativeint[<System.Security.SecurityCritical>]
static member StringToCoTaskMemUTF8 : string -> nativeintPublic Shared Function StringToCoTaskMemUTF8 (s As String) As IntPtrParâmetros
- s
- String
Uma cadeia de caracteres gerenciada a ser copiada.
Retornos
nativeint
Um inteiro que representa um ponteiro para o bloco de memória alocado na cadeia de caracteres ou 0, se s for null.
- Atributos
Exceções
O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.
Memória insuficiente.
Comentários
StringToCoTaskMemUTF8 é ú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, incluindo um terminador nulo, sempre libere a memória chamando Marshal.FreeCoTaskMem. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringUTF8. Os caracteres da cadeia de caracteres são copiados como caracteres UTF-8.
