Marshal.StringToCoTaskMemAnsi(String) Methode

Definitie

Hiermee kopieert u de inhoud van een beheerd String naar een blok geheugen dat is toegewezen vanuit de onbeheerde COM-taaktoewijzing.

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

Parameters

s
String

Een beheerde tekenreeks die moet worden gekopieerd.

Retouren

IntPtr

nativeint

Een geheel getal dat een aanwijzer aangeeft aan het blok geheugen dat is toegewezen voor de tekenreeks, of 0 als s dat het is null.

Kenmerken

Uitzonderingen

Er is onvoldoende geheugen beschikbaar.

De s parameter overschrijdt de maximale lengte die door het besturingssysteem is toegestaan.

Opmerkingen

StringToCoTaskMemAnsi is handig voor aangepaste marshaling of bij het combineren van beheerde en onbeheerde code. Omdat met deze methode het niet-beheerde geheugen wordt toegewezen dat is vereist voor een tekenreeks, kunt u altijd het geheugen vrijmaken door aan te roepen FreeCoTaskMem. Deze methode biedt de tegenovergestelde functionaliteit van Marshal.PtrToStringAnsi. De tekens van de tekenreeks worden gekopieerd als ANSI-tekens.

Van toepassing op

Zie ook