Marshal.StringToCoTaskMemAnsi(String) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.dll

Kaynak:

Marshal.cs

Yönetilen String bir öğenin içeriğini yönetilmeyen COM görev ayırıcısından ayrılan bir bellek bloğuna kopyalar.

public:
 static IntPtr StringToCoTaskMemAnsi(System::String ^ s);

public static IntPtr StringToCoTaskMemAnsi (string? s);

static member StringToCoTaskMemAnsi : string -> nativeint

Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Parametreler

s

String

Kopyalanacak yönetilen dize.

Döndürülenler

IntPtr

nativeint

Dize için ayrılan bellek bloğunun işaretçisini temsil eden bir tamsayı veya ise s 0.null

Özel durumlar

OutOfMemoryException

Kullanılabilir bellek yetersiz.

ArgumentOutOfRangeException

parametresi, s işletim sisteminin izin verdiği uzunluk üst sınırını aşıyor.

Açıklamalar

StringToCoTaskMemAnsi özel hazırlama için veya yönetilen ve yönetilmeyen kodu karıştırırken kullanışlıdır. Bu yöntem bir dize için gereken yönetilmeyen belleği ayırdığından, çağırarak FreeCoTaskMembelleği her zaman boşaltın. Bu yöntem, işlevinin tersini Marshal.PtrToStringAnsisağlar. Dizenin karakterleri ANSI karakterleri olarak kopyalanır.

Ayrıca bkz.

• FreeCoTaskMem(IntPtr)
• PtrToStringAnsi(IntPtr)