Marshal.StringToCoTaskMemAnsi(String) Yöntem

Tanım

Yönetilen öğesinin içeriğini String YÖNETILMEYEN com görev ayırıcılarından ayrılan bir bellek bloğuna kopyalar.Copies the contents of a managed String to a block of memory allocated from the unmanaged COM task allocator.

public:
 static IntPtr StringToCoTaskMemAnsi(System::String ^ s);
public static IntPtr StringToCoTaskMemAnsi (string s);
[System.Security.SecurityCritical]
public static IntPtr StringToCoTaskMemAnsi (string s);
static member StringToCoTaskMemAnsi : string -> nativeint
[<System.Security.SecurityCritical>]
static member StringToCoTaskMemAnsi : string -> nativeint
Public Shared Function StringToCoTaskMemAnsi (s As String) As IntPtr

Parametreler

s
String

Kopyalanacak yönetilen dize.A managed string to be copied.

Döndürülenler

IntPtr

Dize için ayrılan bellek bloğunun işaretçisini temsil eden bir tamsayı veya ise 0 s null .An integer representing a pointer to the block of memory allocated for the string, or 0 if s is null.

Öznitelikler

Özel durumlar

Yeterli kullanılabilir bellek yok.There is insufficient memory available.

sParametre, işletim sistemi tarafından izin verilen en fazla uzunluğu aşıyor.The s parameter exceeds the maximum length allowed by the operating system.

Açıklamalar

StringToCoTaskMemAnsi Özel sıralama veya yönetilen ve yönetilmeyen kod karıştırma için yararlıdır.StringToCoTaskMemAnsi is useful for custom marshaling or when mixing managed and unmanaged code. Bu yöntem, bir dize için gereken yönetilmeyen belleği ayırdığından, çağırarak her zaman belleği serbest bırakır FreeCoTaskMem .Because this method allocates the unmanaged memory required for a string, always free the memory by calling FreeCoTaskMem. Bu yöntem, uygulamasının karşıt işlevlerini sağlar Marshal.PtrToStringAnsi .This method provides the opposite functionality of Marshal.PtrToStringAnsi. Dizenin karakterleri ANSI karakter olarak kopyalanır.The characters of the string are copied as ANSI characters.

Şunlara uygulanır

Ayrıca bkz.