System.Runtime.InteropServices.Marshal.SecureStringToBSTR Method

Allocates a BSTR and copies the contents of a managed System.Security.SecureString object into it.

Syntax

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

Parameters

s
The managed object to copy.

Returns

The address, in unmanaged memory, where the s parameter was copied to, or 0 if a null object was supplied.

Remarks

The Marshal.SecureStringToBSTR(System.Security.SecureString) method is useful for custom marshaling or when mixing managed and unmanaged code. Because this method allocates the unmanaged memory required for a string, always free the BSTR when finished by calling the Marshal.ZeroFreeBSTR(IntPtr) method.

Requirements

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 2.0.0.0, 4.0.0.0
Since: .NET 2.0