Marshal.StringToCoTaskMemAuto(String) 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

來源:

Marshal.Unix.cs

複製 Managed String 的內容到從 Unmanaged COM 工作配置器配置的記憶體區塊。

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

public static IntPtr StringToCoTaskMemAuto (string? s);

static member StringToCoTaskMemAuto : string -> nativeint

Public Shared Function StringToCoTaskMemAuto (s As String) As IntPtr

參數

s

String

要複製的 Managed 字串。

傳回

IntPtr

nativeint

配置的記憶體區塊，如果 s 為 null 則為 0。

例外狀況

OutOfMemoryException

可用的記憶體不足。

ArgumentOutOfRangeException

s 的長度超出範圍。

備註

StringToCoTaskMemAuto 適用於自定義封送處理，或在混合 Managed 和 Unmanaged 程式代碼時使用。 因為這個方法會配置字串所需的 Unmanaged 記憶體，所以一律會呼叫 FreeCoTaskMem來釋放記憶體。 這個方法提供的 Marshal.PtrToStringAuto相反功能。

字串的字元會複製為 Unicode 字元。

另請參閱

• PtrToStringAuto(IntPtr, Int32)