Marshal.ZeroFreeCoTaskMemAnsi(IntPtr) Methode

Definition

Namespace:

System.Runtime.InteropServices

Assemblys:

netstandard.dll, System.Runtime.InteropServices.dll

Quelle:

Marshal.cs

Gibt einen nicht verwalteten Zeichenfolgenzeiger frei, der mit der SecureStringToCoTaskMemAnsi(SecureString)-Methode reserviert wurde.

C#

public static void ZeroFreeCoTaskMemAnsi(IntPtr s);

Parameter

s

IntPtr

Die Adresse der nicht verwalteten Zeichenfolge, die freigegeben werden soll.

Beispiele

Im folgenden Beispiel wird die SecureStringToCoTaskMemAnsi -Methode verwendet, um den Inhalt eines SecureString Objekts in einen Block nicht verwalteten Arbeitsspeichers zu marshallen und zu entschlüsseln. Anschließend wird die ZeroFreeCoTaskMemAnsi -Methode verwendet, um den nicht verwalteten Block zu löschen und zu löschen.

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

Hinweise

Die ZeroFreeCoTaskMemAnsi -Methode stellt zuerst null und gibt dann nicht verwalteten Arbeitsspeicher frei, der mithilfe der SecureStringToCoTaskMemAnsi -Methode zugeordnet wurde.

Gilt für: