Marshal.StringToCoTaskMemAnsi(String) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Copia il contenuto di un oggetto String gestito in un blocco di memoria allocato dall'allocatore di memoria delle attività COM non gestite.

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 -> nativeint

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Parametri

s: String

Stringa gestita da copiare.

Restituisce

IntPtr nativeint

Intero che rappresenta un puntatore al blocco di memoria allocato per la stringa oppure 0 se s è null.

Attributi: SecurityCriticalAttribute

Eccezioni

OutOfMemoryException

La memoria disponibile è insufficiente.

ArgumentOutOfRangeException

Il parametro s supera la lunghezza massima consentita dal sistema operativo.

Commenti

StringToCoTaskMemAnsi è utile per il marshalling personalizzato o quando si combina codice gestito e non gestito. Poiché questo metodo alloca la memoria non gestita necessaria per una stringa, libera sempre la memoria chiamando FreeCoTaskMem. Questo metodo fornisce la funzionalità opposta di Marshal.PtrToStringAnsi. I caratteri della stringa vengono copiati come caratteri ANSI.

Si applica a