Marshal.StringToCoTaskMemAnsi(String) Método

Definição

Namespace:: System.Runtime.InteropServices

Assemblies:: System.Runtime.InteropServices.dll, mscorlib.dll, netstandard.dll

Copia o conteúdo de um String gerenciado para um bloco de memória alocado do alocador de tarefas COM não gerenciado.Copies the contents of a managed String to a block of memory allocated from the unmanaged COM task allocator.

public:
 static IntPtr StringToCoTaskMemAnsi(System::String ^ s);

[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemAnsi (string s);

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Parâmetros

s: String

Uma cadeia de caracteres gerenciada a ser copiada.A managed string to be copied.

Retornos

IntPtr

Um inteiro que representa um ponteiro para o bloco de memória alocado na cadeia de caracteres ou 0, se s for null.An integer representing a pointer to the block of memory allocated for the string, or 0 if s is null.

Atributos: SecurityCriticalAttribute

Exceções

OutOfMemoryException

Memória insuficiente.There is insufficient memory available.

ArgumentOutOfRangeException

O parâmetro s excede o tamanho máximo permitido pelo sistema operacional.The s parameter exceeds the maximum length allowed by the operating system.

Comentários

StringToCoTaskMemAnsi é útil para marshaling personalizado ou ao misturar código gerenciado e não gerenciado.StringToCoTaskMemAnsi is useful for custom marshaling or when mixing managed and unmanaged code. 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.Because this method allocates the unmanaged memory required for a string, always free the memory by calling FreeCoTaskMem. Esse método fornece a funcionalidade oposta de Marshal.PtrToStringAnsi.This method provides the opposite functionality of Marshal.PtrToStringAnsi. Os caracteres da cadeia de caracteres são copiados como caracteres ANSI.The characters of the string are copied as ANSI characters.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.