Marshal.StringToCoTaskMemAnsi(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 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 -> nativeintstatic member StringToCoTaskMemAnsi : string -> nativeintPublic Shared Function StringToCoTaskMemAnsi (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
Memória insuficiente.
O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.
Comentários
StringToCoTaskMemAnsi é útil para marshaling personalizado ou 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 FreeCoTaskMem. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringAnsi. Os caracteres da cadeia de caracteres são copiados como caracteres ANSI.
