Marshal.ZeroFreeCoTaskMemAnsi(IntPtr) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Kaynak:

Marshal.cs

yöntemi kullanılarak ayrılan yönetilmeyen bir dize işaretçisini SecureStringToCoTaskMemAnsi(SecureString) serbest koyar.

C#

public static void ZeroFreeCoTaskMemAnsi(IntPtr s);

Parametreler

s

IntPtr

Yönetilmeyen dizenin serbest olarak dağıtıldığı adres.

Ö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.

C#

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;
     }
}

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.

Şunlara uygulanır