SecureStringMarshal.SecureStringToGlobalAllocAnsi(SecureString) 方法

定義

命名空間:

System.Security

組件:

System.Runtime.InteropServices.dll

來源:

SecureStringMarshal.cs

將 Managed SecureString 的內容複製到 Unmanaged 記憶體中，並在它複製時轉換成 ANSI 格式。

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

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

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

Public Shared Function SecureStringToGlobalAllocAnsi (s As SecureString) As IntPtr

參數

s

SecureString

要複製的 Managed 物件。

傳回

IntPtr

nativeint

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

例外狀況

ArgumentNullException

s 參數為 null。

OutOfMemoryException

可用的記憶體不足。

備註

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