Marshal.SecureStringToCoTaskMemUnicode(SecureString) 方法

定義

重要

此 API 不符合 CLS 規範。

將 Managed SecureString 物件的內容複製到從 Unmanaged COM 工作配置器配置的記憶體區塊。

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

參數

s
SecureString

要複製的 Managed 物件。

傳回

IntPtr

Unmanaged 記憶體中複製 s 參數的目的位址;如果提供 Null 物件,則為 0。

屬性

例外狀況

s 參數為 null

可用的記憶體不足。

範例

下列範例會 SecureStringToCoTaskMemUnicode 使用 方法來封送處理對象的內容 SecureString ,並將其解密為 Unmanaged 記憶體區塊。 然後, ZeroFreeCoTaskMemUnicode 它會使用 方法來零出並處置 Unmanaged 區塊。

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

        if (unmanagedRef != IntPtr.Zero) {
            Console.WriteLine("Zeroing out unmanaged memory...");
            Marshal.ZeroFreeCoTaskMemUnicode(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.

備註

此方法 SecureStringToCoTaskMemUnicode 適用於自定義封送處理,或在混合 Managed 和 Unmanaged 程式代碼時使用。 因為這個方法會配置字串所需的 Unmanaged 記憶體,所以一律會呼叫 ZeroFreeCoTaskMemUnicode 方法來釋放記憶體。 字串的字元會複製為 Unicode 字元。

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1