Marshal.StringToCoTaskMemAnsi(String) Metoda

Reference

Definice

Obor názvů:: System.Runtime.InteropServices

Sestavení:: System.Runtime.InteropServices.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zkopíruje obsah spravovaného String do bloku paměti přiděleného nespravovanému úkolu 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: SecurityCriticalAttribute

Výjimky

OutOfMemoryException

Není k dispozici dostatek paměti.

ArgumentOutOfRangeException

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čnou funkci Marshal.PtrToStringAnsi. Znaky řetězce se zkopírují jako znaky ANSI.

Platí pro