Marshal.SecureStringToCoTaskMemUnicode メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Marshal.SecureStringToCoTaskMemUnicode メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

アンマネージ COM タスクアロケータから割り当てられたメモリブロックに、マネージ SecureString オブジェクトの内容をコピーします。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function SecureStringToCoTaskMemUnicode
 ( _
    s As SecureString _
) As IntPtr

Visual Basic (使用法)

Dim s As SecureString
Dim returnValue As IntPtr

returnValue = Marshal.SecureStringToCoTaskMemUnicode(s)

public static IntPtr SecureStringToCoTaskMemUnicode
 (
    SecureString s
)

C++

public:
static IntPtr SecureStringToCoTaskMemUnicode (
    SecureString^ s
)

public static IntPtr SecureStringToCoTaskMemUnicode
 (
    SecureString s
)

JScript

public static function SecureStringToCoTaskMemUnicode
 (
    s : SecureString
) : IntPtr

パラメータ

s: コピーするマネージ SecureString オブジェクト。

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

例外

例外の種類	条件
ArgumentNullException	s パラメータが null 参照 (Visual Basic では Nothing) です。
NotSupportedException	現在のコンピュータは、Microsoft Windows 2000 Service Pack 3 以降を実行していません。
OutOfMemoryException	使用できるメモリが不足しています。

解説

SecureStringToCoTaskMemUnicode メソッドは、カスタムマーシャリングを実行する場合、またはマネージコードとアンマネージコードを混在させる場合に役立ちます。このメソッドは文字列で必要とされるアンマネージメモリを割り当てるため、必ず ZeroFreeCoTaskMemUnicode メソッドを呼び出してメモリを解放してください。文字列の文字は、Unicode 文字としてコピーされます。

メモ
このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。

メモ

このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。

呼び出し時の注意 このメソッドがサポートされるのは、Microsoft Windows 2000 Service Pack 3 以降を実行しているコンピュータ上だけです。

使用例

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

Visual Basic

Imports System
Imports System.Diagnostics
Imports System.Runtime.InteropServices
Imports System.Security
Imports System.Security.Principal
Imports System.Text




Module MarshalExample



    Sub Main(ByVal args() As
 String)

        Dim unmanagedRef As IntPtr

        Try
            ' 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.SecureStringToCoTaskMemUnicode(passWord)


        Catch e As Exception
            Console.WriteLine(e.Message)
        Finally

            If unmanagedRef <> IntPtr.Size Then

                Console.WriteLine("Zeroing out unmanaged memory...")

                Marshal.ZeroFreeCoTaskMemUnicode(unmanagedRef)

            End If

        End Try

        Console.WriteLine("Done.")

        Console.ReadLine()

    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

using System;
using System.Diagnostics;
using System.Runtime.InteropServices;
using System.Security;
using System.Security.Principal;
using System.Text;

namespace SecureStringExample
{

    class MarshalExample
    {


        static void Main(string[]
 args)
        {
            IntPtr unmanagedRef = IntPtr.Zero;

            try
            {
                // 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.SecureStringToCoTaskMemUnicode(passWord);


            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
            finally
            {
                if (unmanagedRef != IntPtr.Zero)
                {
                    Console.WriteLine("Zeroing out unmanaged memory...");

                    Marshal.ZeroFreeCoTaskMemUnicode(unmanagedRef);
                }

            }

            Console.WriteLine("Done.");

            Console.ReadLine();


        }

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