Marshal.StringToCoTaskMemUni(String) 方法

定义

将托管 String 的内容复制到从非托管 COM 任务分配器分配的内存块。

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

参数

s
String

要复制的托管字符串。

返回

IntPtr

nativeint

一个整数,表示指向为字符串分配的内存块的指针;如果 s 为 null,则为 0。

属性

例外

s 参数超过了操作系统所允许的最大长度。

没有足够的可用内存。

注解

StringToCoTaskMemUni 可用于自定义封送处理或在混合托管和非托管代码时使用。 由于此方法分配字符串所需的非托管内存,因此请始终通过调用 Marshal.FreeCoTaskMem释放内存。 此方法提供 的相反功能 Marshal.PtrToStringUni。 字符串的字符将复制为 Unicode 字符。

此 API 反映了 Unicode 的 Windows 定义,Unicode 是 UTF-16 2 字节编码。 在许多非 Windows 平台上, wchar_t 数据类型为 4 字节,而不是 2 字节。 请咨询编译器,确认是否可以 wchar_t 使用或 char16_t 应改用。

适用于

另请参阅