Marshal.StringToCoTaskMemUTF8(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Copia o conteúdo de um managed String para um bloco de memória alocado a partir do alocador de tarefas COM não gerido.
public:
static IntPtr StringToCoTaskMemUTF8(System::String ^ s);public static IntPtr StringToCoTaskMemUTF8(string s);static member StringToCoTaskMemUTF8 : string -> nativeintPublic Shared Function StringToCoTaskMemUTF8 (s As String) As IntPtrParâmetros
- s
- String
Uma sequência gerida para ser copiada.
Devoluções
nativeint
Um inteiro representando um ponteiro para o bloco de memória alocado para a cadeia, ou 0 se s for null.
Exceções
O s parâmetro excede o comprimento máximo permitido pelo sistema operativo.
Há memória insuficiente disponível.
Observações
StringToCoTaskMemUTF8 é útil para marshaling personalizado ou para uso ao misturar código gerido e não gerido. Como este método aloca a memória não gerida necessária para uma cadeia incluindo um terminador nulo, liberte sempre a memória chamando Marshal.FreeCoTaskMem. Este método fornece a funcionalidade oposta de Marshal.PtrToStringUTF8. Os caracteres da cadeia são copiados como caracteres UTF-8.