Marshal.SecureStringToBSTR(SecureString) 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

來源:

Marshal.cs

重要

此 API 不符合 CLS 規範。

配置 Unmanaged 二進位字串 (BSTR)，並將 Managed SecureString 物件的內容複製到其中。

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

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

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

Public Shared Function SecureStringToBSTR (s As SecureString) As IntPtr

參數

s

SecureString

要複製的 Managed 物件。

傳回

IntPtr

nativeint

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

例外狀況

ArgumentNullException

s 參數為 null。

OutOfMemoryException

可用的記憶體不足。

備註

方法 SecureStringToBSTR 適用於自定義封送處理，或在混合 Managed 和 Unmanaged 程式代碼時使用。 因為這個方法會設定字串所需的 Unmanaged 記憶體，所以呼叫 方法完成時ZeroFreeBSTR，請一律釋放 BSTR 。