Marshal.SecureStringToBSTR(SecureString) Marshal.SecureStringToBSTR(SecureString) Marshal.SecureStringToBSTR(SecureString) Marshal.SecureStringToBSTR(SecureString) Method

Definition

Important

This API is not CLS-compliant.

Allocates an unmanaged binary string (BSTR) and copies the contents of a managed SecureString object into it.

public:
 static IntPtr SecureStringToBSTR(System::Security::SecureString ^ s);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public static IntPtr SecureStringToBSTR (System.Security.SecureString s);
static member SecureStringToBSTR : System.Security.SecureString -> nativeint
Public Shared Function SecureStringToBSTR (s As SecureString) As IntPtr
Parameters
s
SecureString SecureString SecureString SecureString

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.

Exceptions

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

Remarks

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.

Security

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

Applies to