SecureStringMarshal.SecureStringToCoTaskMemAnsi(SecureString) 方法

定義

命名空間:

System.Security

組件:

System.Runtime.InteropServices.dll

來源:

SecureStringMarshal.cs

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

public:
 static IntPtr SecureStringToCoTaskMemAnsi(System::Security::SecureString ^ s);

public static IntPtr SecureStringToCoTaskMemAnsi (System.Security.SecureString s);

static member SecureStringToCoTaskMemAnsi : System.Security.SecureString -> nativeint

Public Shared Function SecureStringToCoTaskMemAnsi (s As SecureString) As IntPtr

參數

s

SecureString

要複製的 Managed 物件。

傳回

IntPtr

nativeint

Unmanaged 記憶體中複製 s 參數的目的位址；如果提供 Null 物件，則為 0。

例外狀況

ArgumentNullException

s 參數為 null。

OutOfMemoryException

可用的記憶體不足。

備註

此方法 SecureStringToCoTaskMemAnsi 適用於自定義封送處理，或在混合 Managed 和 Unmanaged 程式代碼時使用。 因為這個方法會配置字串所需的 Unmanaged 記憶體，所以一律呼叫 ZeroFreeCoTaskMemAnsi來釋放記憶體。 字串的字元會複製為 ANSI 字元。