Marshal.SecureStringToGlobalAllocAnsi(SecureString) メソッド

定義

名前空間:

System.Runtime.InteropServices

アセンブリ:

System.Runtime.InteropServices.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

重要

この API は CLS 準拠ではありません。

マネージド SecureString の内容をアンマネージド メモリにコピーし、コピー時に ANSI 形式に変換します。

public:
 static IntPtr SecureStringToGlobalAllocAnsi(System::Security::SecureString ^ s);

public static IntPtr SecureStringToGlobalAllocAnsi (System.Security.SecureString s);

[System.CLSCompliant(false)]
public static IntPtr SecureStringToGlobalAllocAnsi (System.Security.SecureString s);

[System.Security.SecurityCritical]
public static IntPtr SecureStringToGlobalAllocAnsi (System.Security.SecureString s);

static member SecureStringToGlobalAllocAnsi : System.Security.SecureString -> nativeint

[<System.CLSCompliant(false)>]
static member SecureStringToGlobalAllocAnsi : System.Security.SecureString -> nativeint

[<System.Security.SecurityCritical>]
static member SecureStringToGlobalAllocAnsi : System.Security.SecureString -> nativeint

Public Shared Function SecureStringToGlobalAllocAnsi (s As SecureString) As IntPtr

パラメーター

s

SecureString

コピーするマネージド オブジェクト。

戻り値

IntPtr

nativeint

s パラメーターのコピー先となったアンマネージ メモリ内のアドレス。null オブジェクトが指定された場合は 0。

属性

CLSCompliantAttribute SecurityCriticalAttribute

例外

ArgumentNullException

s パラメーターが null です。

OutOfMemoryException

使用できるメモリが不足しています。

例

次の例では、メソッドを SecureStringToGlobalAllocAnsi 使用してオブジェクトの SecureString 内容をマーシャリングし、アンマネージド メモリのブロックに復号化します。 次に、このメソッドを ZeroFreeGlobalAllocAnsi 使用して、アンマネージド ブロックをゼロにして破棄します。

using System;
using System.Runtime.InteropServices;
using System.Security;

class Example
{
    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.SecureStringToGlobalAllocAnsi(passWord);
        passWord.Dispose();

        if (unmanagedRef != IntPtr.Zero) {
            Console.WriteLine("Zeroing out unmanaged memory...");
            Marshal.ZeroFreeGlobalAllocAnsi(unmanagedRef);
        }
        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;
    }
}
// The example displays output like the following:
//       Please enter your password: ********
//       Copying and decrypting the string to unmanaged memory...
//       Zeroing out unmanaged memory...
//       Done.

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.SecureStringToGlobalAllocAnsi(passWord)
        passWord.Dispose()

        If unmanagedRef <> IntPtr.Zero Then
            Console.WriteLine("Zeroing out unmanaged memory...")
            Marshal.ZeroFreeGlobalAllocAnsi(unmanagedRef)
        End If
        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
' The example displays output like the following:
'       Please enter your password: ********
'       Copying and decrypting the string to unmanaged memory...
'       Zeroing out unmanaged memory...
'       Done.

注釈

このメソッドは SecureStringToGlobalAllocAnsi 、カスタム マーシャリングや、マネージド コードとアンマネージド コードを混在させると便利です。 このメソッドは文字列に必要なアンマネージ メモリを割り当てるので、常にメソッドを呼び出してメモリを ZeroFreeGlobalAllocAnsi 解放します。