Export (0) Print
Expand All

Marshal.SecureStringToBSTR Method

Allocates a BSTR Data Type and copies the contents of a managed SecureString object into it.

Namespace:  System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

static member SecureStringToBSTR : 
        s:SecureString -> IntPtr

Parameters

s
Type: System.Security.SecureString

The managed object to copy.

Return Value

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

ExceptionCondition
ArgumentNullException

The s parameter is a null reference (Nothing in Visual Basic).

NotSupportedException

The current computer is not running Windows 2000 Service Pack 3 or later.

OutOfMemoryException

There is insufficient memory available.

The SecureStringToBSTR 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 ZeroFreeBSTR method.

Notes to Callers

This method is supported only on computers running Windows 2000 Service Pack 3 or later.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

  • SecurityCriticalAttribute 

    requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Show:
© 2015 Microsoft