Marshal.ZeroFreeCoTaskMemAnsi(IntPtr) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membebaskan penunjuk string tidak terkelola yang dialokasikan menggunakan SecureStringToCoTaskMemAnsi(SecureString) metode .
public:
static void ZeroFreeCoTaskMemAnsi(IntPtr s);
[System.Security.SecurityCritical]
public static void ZeroFreeCoTaskMemAnsi (IntPtr s);
public static void ZeroFreeCoTaskMemAnsi (IntPtr s);
[<System.Security.SecurityCritical>]
static member ZeroFreeCoTaskMemAnsi : nativeint -> unit
static member ZeroFreeCoTaskMemAnsi : nativeint -> unit
Public Shared Sub ZeroFreeCoTaskMemAnsi (s As IntPtr)
Parameter
- s
-
IntPtr
nativeint
Alamat string yang tidak dikelola untuk dibebaskan.
- Atribut
Contoh
Contoh berikut menggunakan SecureStringToCoTaskMemAnsi metode untuk marshal dan mendekripsi SecureString konten objek ke blok memori yang tidak dikelola. Kemudian menggunakan ZeroFreeCoTaskMemAnsi metode untuk nol keluar dan membuang blok yang tidak dikelola.
using System;
using System.Runtime.InteropServices;
using System.Security;
class MarshalExample
{
static void Main()
{
IntPtr unmanagedRef = IntPtr.Zero;
// Ask the user for a password.
Console.Write("Please enter your password: ");
SecureString passWord = GetPassword();
Console.WriteLine("Copying and decrypting the string to unmanaged memory...");
// Copy the Secure string to unmanaged memory (and decrypt it).
unmanagedRef = Marshal.SecureStringToCoTaskMemAnsi(passWord);
if (unmanagedRef != IntPtr.Zero)
{
Console.WriteLine("Zeroing out unmanaged memory...");
Marshal.ZeroFreeCoTaskMemAnsi(unmanagedRef);
}
passWord.Dispose();
Console.WriteLine("Done.");
}
public static SecureString GetPassword()
{
SecureString password = new SecureString();
// get the first character of the password
ConsoleKeyInfo nextKey = Console.ReadKey(true);
while (nextKey.Key != ConsoleKey.Enter)
{
if (nextKey.Key == ConsoleKey.Backspace)
{
if (password.Length > 0)
{
password.RemoveAt(password.Length - 1);
// erase the last * as well
Console.Write(nextKey.KeyChar);
Console.Write(" ");
Console.Write(nextKey.KeyChar);
}
}
else
{
password.AppendChar(nextKey.KeyChar);
Console.Write("*");
}
nextKey = Console.ReadKey(true);
}
Console.WriteLine();
// lock the password down
password.MakeReadOnly();
return password;
}
}
Imports System.Runtime.InteropServices
Imports System.Security
Module Example
Sub Main()
Dim unmanagedRef As IntPtr
' Ask the user for a password.
Console.Write("Please enter your password: ")
Dim passWord As SecureString = GetPassword()
Console.WriteLine("Copying and decrypting the string to unmanaged memory...")
' Copy the Secure string to unmanaged memory (and decrypt it).
unmanagedRef = Marshal.SecureStringToCoTaskMemAnsi(passWord)
If unmanagedRef <> IntPtr.Size Then
Console.WriteLine("Zeroing out unmanaged memory...")
Marshal.ZeroFreeCoTaskMemAnsi(unmanagedRef)
End If
passWord.Dispose()
Console.WriteLine("Done.")
End Sub
Function GetPassword() As SecureString
Dim password As New SecureString()
' get the first character of the password
Dim nextKey As ConsoleKeyInfo = Console.ReadKey(True)
While nextKey.Key <> ConsoleKey.Enter
If nextKey.Key = ConsoleKey.BackSpace Then
If password.Length > 0 Then
password.RemoveAt(password.Length - 1)
' erase the last * as well
Console.Write(nextKey.KeyChar)
Console.Write(" ")
Console.Write(nextKey.KeyChar)
End If
Else
password.AppendChar(nextKey.KeyChar)
Console.Write("*")
End If
nextKey = Console.ReadKey(True)
End While
Console.WriteLine()
' lock the password down
password.MakeReadOnly()
Return password
End Function
End Module
Keterangan
Metode ZeroFreeCoTaskMemAnsi pertama-tama nol keluar dan kemudian membebaskan memori tidak terkelola yang dialokasikan menggunakan SecureStringToCoTaskMemAnsi metode .