Marshal.ZeroFreeCoTaskMemAnsi(IntPtr) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
yöntemi kullanılarak ayrılan yönetilmeyen bir dize işaretçisini SecureStringToCoTaskMemAnsi(SecureString) serbest koyar.
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)
Parametreler
- s
-
IntPtr
nativeint
Yönetilmeyen dizenin serbest olarak dağıtıldığı adres.
- Öznitelikler
Örnekler
Aşağıdaki örnek, bir nesnenin SecureStringToCoTaskMemAnsi içeriğini yönetilmeyen bellek SecureString bloğuna sıralamak ve şifresini çözmek için yöntemini kullanır. Ardından yöntemini kullanarak ZeroFreeCoTaskMemAnsi sıfırlar ve yönetilmeyen bloğu atılır.
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
Açıklamalar
ZeroFreeCoTaskMemAnsi yöntemi önce sıfırdan çıkar ve ardından yöntemi kullanılarak SecureStringToCoTaskMemAnsi ayrılan yönetilmeyen belleği serbest bırakır.