Marshal.StringToCoTaskMemAnsi(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
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.