Marshal.StringToCoTaskMemUni(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 StringToCoTaskMemUni(System::String ^ s);

public static IntPtr StringToCoTaskMemUni (string? s);

static member StringToCoTaskMemUni : string -> nativeint

Public Shared Function StringToCoTaskMemUni (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 s ise 0.null

Özel durumlar

ArgumentOutOfRangeException

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

OutOfMemoryException

Kullanılabilir bellek yetersiz.

Açıklamalar

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

Bu API, UTF-16 2 bayt kodlaması olan Unicode'un Windows tanımını yansıtır. Windows olmayan birçok platformda wchar_t veri türü 2 bayt değil 4 bayttır. Bunun yerine kullanılıp kullanılamayabileceğini veya char16_t kullanılması gerektiğini onaylamak wchar_t için derleyicinize başvurun.

Ayrıca bkz.

• FreeCoTaskMem(IntPtr)
• PtrToStringUni(IntPtr, Int32)