Marshal.StringToCoTaskMemAnsi(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 StringToCoTaskMemAnsi(System::String ^ s);[System.Security.SecurityCritical]
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 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.
- Atributos
Exceções
Há memória insuficiente disponível.
O s parâmetro excede o comprimento máximo permitido pelo sistema operativo.
Observações
StringToCoTaskMemAnsi é útil para marshaling personalizado ou 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, liberte sempre a memória chamando FreeCoTaskMem. Este método fornece a funcionalidade oposta de Marshal.PtrToStringAnsi. Os caracteres da cadeia são copiados como caracteres ANSI.