Marshal.ZeroFreeCoTaskMemAnsi(IntPtr) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SecureStringToCoTaskMemAnsi(SecureString) メソッドを使用して割り当てられたアンマネージ文字列ポインターを解放します。
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)
パラメーター
- s
-
IntPtr
nativeint
解放するアンマネージ文字列のアドレス。
- 属性
例
次の例では、 メソッドを SecureStringToCoTaskMemAnsi 使用して、オブジェクトの内容をアンマネージド メモリの SecureString ブロックにマーシャリングおよび復号化します。 次に、 メソッドを ZeroFreeCoTaskMemAnsi 使用して、アンマネージド ブロックをゼロにして破棄します。
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
注釈
メソッドは ZeroFreeCoTaskMemAnsi 最初にゼロアウトし、 メソッドを使用して割り当てられたアンマネージド メモリを SecureStringToCoTaskMemAnsi 解放します。
適用対象
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET