Marshal.StringToCoTaskMemAnsi(String) Metoda

Definice

Zkopíruje obsah spravovaného String do bloku paměti přiděleného z nespravovaného alokátoru úloh modelu COM.

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

Parametry

s
String

Spravovaný řetězec, který se má zkopírovat.

Návraty

IntPtr

nativeint

Celé číslo představující ukazatel na blok paměti přidělený řetězci nebo 0, pokud s je null.

Atributy

Výjimky

Není k dispozici dostatek paměti.

Parametr s překračuje maximální délku povolenou operačním systémem.

Poznámky

StringToCoTaskMemAnsi je užitečná pro vlastní zařazování nebo při kombinování spravovaného a nespravovaného kódu. Vzhledem k tomu, že tato metoda přidělí nespravovanou paměť potřebnou pro řetězec, vždy uvolněte paměť voláním FreeCoTaskMem. Tato metoda poskytuje opačné funkce než Marshal.PtrToStringAnsi. Znaky řetězce se zkopírují jako znaky ANSI.

Platí pro

Viz také