System.Runtime.InteropServices.Marshal.SecureStringToCoTaskMemAnsi Method

Copies the contents of a managed System.Security.SecureString object to a block of memory allocated from the unmanaged COM task allocator.

Syntax

public static IntPtr SecureStringToCoTaskMemAnsi (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.SecureStringToCoTaskMemAnsi(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 memory by calling Marshal.ZeroFreeCoTaskMemAnsi(IntPtr). The characters of the string are copied as ANSI characters.

Requirements

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