CspParameters Konstruktoren

Definition

Initialisiert eine neue Instanz der CspParameters-Klasse.

Überlädt

Name Beschreibung
CspParameters()

Initialisiert eine neue Instanz der CspParameters-Klasse.

CspParameters(Int32)

Initialisiert eine neue Instanz der CspParameters Klasse mit dem angegebenen Anbietertypcode.

CspParameters(Int32, String)

Initialisiert eine neue Instanz der CspParameters Klasse mit dem angegebenen Anbietertypcode und -namen.

CspParameters(Int32, String, String)

Initialisiert eine neue Instanz der CspParameters Klasse mit dem angegebenen Anbietertypcode und -namen und dem angegebenen Containernamen.

CspParameters(Int32, String, String, CryptoKeySecurity, IntPtr)

Initialisiert eine neue Instanz der CspParameters Klasse mit einem Anbietertyp, einem Anbieternamen, einem Containernamen, Zugriffsinformationen und einem Handle für ein nicht verwaltetes Smartcardkennwortdialogfeld.

CspParameters(Int32, String, String, CryptoKeySecurity, SecureString)

Initialisiert eine neue Instanz der CspParameters Klasse mit einem Anbietertyp, einem Anbieternamen, einem Containernamen, Zugriffsinformationen und einem Kennwort, das einem Smartcardschlüssel zugeordnet ist.

CspParameters()

Initialisiert eine neue Instanz der CspParameters-Klasse.

public:
 CspParameters();
public CspParameters();
Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird ein Schlüsselcontainer mithilfe der CspParameters Klasse erstellt und der Schlüssel im Container gespeichert.

using System;
using System.IO;
using System.Security.Cryptography;

public class StoreKey
{
    public static void Main()
    {
        // creates the CspParameters object and sets the key container name used to store the RSA key pair
        CspParameters cp = new CspParameters();
        cp.KeyContainerName = "MyKeyContainerName";

        // instantiates the rsa instance accessing the key container MyKeyContainerName
        RSACryptoServiceProvider rsa = new RSACryptoServiceProvider(cp);
        // add the below line to delete the key entry in MyKeyContainerName
        // rsa.PersistKeyInCsp = false;

        //writes out the current key pair used in the rsa instance
        Console.WriteLine("Key is : \n" + rsa.ToXmlString(true));
    }
}
Imports System.IO
Imports System.Security.Cryptography



Public Class StoreKey
    
    Public Shared Sub Main()
        ' creates the CspParameters object and sets the key container name used to store the RSA key pair
        Dim cp As New CspParameters()
        cp.KeyContainerName = "MyKeyContainerName"
        
        ' instantiates the rsa instance accessing the key container MyKeyContainerName
        Dim rsa As New RSACryptoServiceProvider(cp)
        ' add the below line to delete the key entry in MyKeyContainerName
        ' rsa.PersistKeyInCsp = false;
        'writes out the current key pair used in the rsa instance
        Console.WriteLine("Key is : "  & rsa.ToXmlString(True))
    End Sub
End Class

Hinweise

Diese Form der Initialisierung des CspParametersProviderType Felds auf einen Wert von 24, der den PROV_RSA_AES Anbieter angibt. Dieser Standardanbieter ist mit dem Aes Algorithmus kompatibel.

Informationen zu anderen Anbietertypen finden Sie im ProviderType Feld.

Weitere Informationen

Gilt für:

CspParameters(Int32)

Initialisiert eine neue Instanz der CspParameters Klasse mit dem angegebenen Anbietertypcode.

public:
 CspParameters(int dwTypeIn);
public CspParameters(int dwTypeIn);
new System.Security.Cryptography.CspParameters : int -> System.Security.Cryptography.CspParameters
Public Sub New (dwTypeIn As Integer)

Parameter

dwTypeIn
Int32

Ein Anbietertypcode, der die Art des zu erstellenden Anbieters angibt.

Hinweise

Verwenden Sie den CspParameters Konstruktor, um einen Anbietertyp anzugeben, indem Sie einen numerischen Wert übergeben, der diesen Anbieter darstellt. Die numerischen Werte, die die Standardanbietertypen darstellen, werden in der WinCrypt.h-Headerdatei definiert:

  • Um einen mit dem RSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 1 den dwTypeIn Parameter.

  • Um einen mit dem DSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 13 den dwTypeIn Parameter.

Informationen zu anderen Anbietertypwerten finden Sie im ProviderType Feld. Weitere Informationen zu den Standardanbietertypen und deren Verhalten finden Sie in der Dokumentation zur Microsoft Cryptography API (CAPI).

Weitere Informationen

Gilt für:

CspParameters(Int32, String)

Initialisiert eine neue Instanz der CspParameters Klasse mit dem angegebenen Anbietertypcode und -namen.

public:
 CspParameters(int dwTypeIn, System::String ^ strProviderNameIn);
public CspParameters(int dwTypeIn, string strProviderNameIn);
new System.Security.Cryptography.CspParameters : int * string -> System.Security.Cryptography.CspParameters
Public Sub New (dwTypeIn As Integer, strProviderNameIn As String)

Parameter

dwTypeIn
Int32

Ein Anbietertypcode, der die Art des zu erstellenden Anbieters angibt.

strProviderNameIn
String

Ein Anbietername.

Beispiele

Im folgenden Codebeispiel wird die CspParameters Klasse verwendet, um einen Kryptografiedienstanbieter für Smartcards auszuwählen. Anschließend werden Daten mit der Smartcard signiert und überprüft.

using System;
using System.Security.Cryptography;

namespace SmartCardSign
{
    class SCSign
    {
        static void Main(string[] args)
        {
            // To idendify the Smart Card CryptoGraphic Providers on your
            // computer, use the Microsoft Registry Editor (Regedit.exe).
            // The available Smart Card CryptoGraphic Providers are listed
            // in HKEY_LOCAL_MACHINE\Software\Microsoft\Cryptography\Defaults\Provider.

            // Create a new CspParameters object that identifies a
            // Smart Card CryptoGraphic Provider.
            // The 1st parameter comes from HKEY_LOCAL_MACHINE\Software\Microsoft\Cryptography\Defaults\Provider Types.
            // The 2nd parameter comes from HKEY_LOCAL_MACHINE\Software\Microsoft\Cryptography\Defaults\Provider.
            CspParameters csp = new CspParameters(1, "Schlumberger Cryptographic Service Provider");
            csp.Flags = CspProviderFlags.UseDefaultKeyContainer;

            // Initialize an RSACryptoServiceProvider object using
            // the CspParameters object.
            RSACryptoServiceProvider rsa = new RSACryptoServiceProvider(csp);

            // Create some data to sign.
            byte[] data = new byte[] { 0, 1, 2, 3, 4, 5, 6, 7 };

            Console.WriteLine("Data			: " + BitConverter.ToString(data));

            // Sign the data using the Smart Card CryptoGraphic Provider.
            byte[] sig = rsa.SignData(data, "SHA256");

            Console.WriteLine("Signature	: " + BitConverter.ToString(sig));

            // Verify the data using the Smart Card CryptoGraphic Provider.
            bool verified = rsa.VerifyData(data, "SHA256", sig);

            Console.WriteLine("Verified		: " + verified);
        }
    }
}
Imports System.Security.Cryptography



Module SCSign

    Sub Main(ByVal args() As String)
        ' To idendify the Smart Card CryptoGraphic Providers on your
        ' computer, use the Microsoft Registry Editor (Regedit.exe).
        ' The available Smart Card CryptoGraphic Providers are listed
        ' in HKEY_LOCAL_MACHINE\Software\Microsoft\Cryptography\Defaults\Provider.

        ' Create a new CspParameters object that identifies a 
        ' Smart Card CryptoGraphic Provider.
        ' The 1st parameter comes from HKEY_LOCAL_MACHINE\Software\Microsoft\Cryptography\Defaults\Provider Types.
        ' The 2nd parameter comes from HKEY_LOCAL_MACHINE\Software\Microsoft\Cryptography\Defaults\Provider.
        Dim csp As New CspParameters(1, "Schlumberger Cryptographic Service Provider")
        csp.Flags = CspProviderFlags.UseDefaultKeyContainer

        ' Initialize an RSACryptoServiceProvider object using
        ' the CspParameters object.
        Dim rsa As New RSACryptoServiceProvider(csp)

        ' Create some data to sign.
        Dim data() As Byte = {0, 1, 2, 3, 4, 5, 6, 7}


        Console.WriteLine("Data   : " + BitConverter.ToString(data))

        ' Sign the data using the Smart Card CryptoGraphic Provider.
        Dim sig As Byte() = rsa.SignData(data, "SHA256")

        Console.WriteLine("Signature : " + BitConverter.ToString(sig))

        ' Verify the data using the Smart Card CryptoGraphic Provider.
        Dim verified As Boolean = rsa.VerifyData(data, "SHA256", sig)

        Console.WriteLine("Verified")

    End Sub

End Module

Hinweise

Verwenden Sie den CspParameters Konstruktor, um einen Anbietertyp und -namen anzugeben.

Geben Sie einen Anbietertyp an, indem Sie einen numerischen Wert übergeben, der den gewünschten Anbietertyp darstellt. Die numerischen Werte, die die Standardanbietertypen darstellen, werden in der WinCrypt.h-Headerdatei definiert:

  • Um einen mit dem RSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 1 den dwTypeIn Parameter.

  • Um einen mit dem DSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 13 den dwTypeIn Parameter.

Informationen zu anderen Anbietertypwerten finden Sie im ProviderType Feld. Weitere Informationen zu den Standardanbietertypen und deren Verhalten finden Sie in der Dokumentation zur Microsoft Cryptography API (CAPI).

Weitere Informationen

Gilt für:

CspParameters(Int32, String, String)

Initialisiert eine neue Instanz der CspParameters Klasse mit dem angegebenen Anbietertypcode und -namen und dem angegebenen Containernamen.

public:
 CspParameters(int dwTypeIn, System::String ^ strProviderNameIn, System::String ^ strContainerNameIn);
public CspParameters(int dwTypeIn, string strProviderNameIn, string strContainerNameIn);
new System.Security.Cryptography.CspParameters : int * string * string -> System.Security.Cryptography.CspParameters
Public Sub New (dwTypeIn As Integer, strProviderNameIn As String, strContainerNameIn As String)

Parameter

dwTypeIn
Int32

Der Anbietertypcode, der die Art des zu erstellenden Anbieters angibt.

strProviderNameIn
String

Ein Anbietername.

strContainerNameIn
String

Ein Containername.

Hinweise

Verwenden Sie den CspParameters Konstruktor, um einen Anbietertyp, einen Anbieternamen und einen Containernamen anzugeben.

Sie können den Containernamen verwenden, um einen Schlüssel in diesem Container abzurufen.

Geben Sie einen Anbietertyp an, indem Sie einen numerischen Wert übergeben, der den gewünschten Anbietertyp darstellt. Die numerischen Werte, die die Standardanbietertypen darstellen, werden in der WinCrypt.h-Headerdatei definiert:

  • Um einen mit dem RSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 1 den dwTypeIn Parameter.

  • Um einen mit dem DSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 13 den dwTypeIn Parameter.

Informationen zu anderen Anbietertypwerten finden Sie im ProviderType Feld. Weitere Informationen zu den Standardanbietertypen und deren Verhalten finden Sie in der Dokumentation zur Microsoft Cryptography API (CAPI).

Weitere Informationen

Gilt für:

CspParameters(Int32, String, String, CryptoKeySecurity, IntPtr)

Initialisiert eine neue Instanz der CspParameters Klasse mit einem Anbietertyp, einem Anbieternamen, einem Containernamen, Zugriffsinformationen und einem Handle für ein nicht verwaltetes Smartcardkennwortdialogfeld.

public:
 CspParameters(int providerType, System::String ^ providerName, System::String ^ keyContainerName, System::Security::AccessControl::CryptoKeySecurity ^ cryptoKeySecurity, IntPtr parentWindowHandle);
public CspParameters(int providerType, string providerName, string keyContainerName, System.Security.AccessControl.CryptoKeySecurity cryptoKeySecurity, IntPtr parentWindowHandle);
new System.Security.Cryptography.CspParameters : int * string * string * System.Security.AccessControl.CryptoKeySecurity * nativeint -> System.Security.Cryptography.CspParameters
Public Sub New (providerType As Integer, providerName As String, keyContainerName As String, cryptoKeySecurity As CryptoKeySecurity, parentWindowHandle As IntPtr)

Parameter

providerType
Int32

Der Anbietertypcode, der die Art des zu erstellenden Anbieters angibt.

providerName
String

Ein Anbietername.

keyContainerName
String

Ein Containername.

cryptoKeySecurity
CryptoKeySecurity

Ein Objekt, das Zugriffsrechte und Überwachungsregeln für den Container darstellt.

parentWindowHandle
IntPtr

nativeint

Ein Handle für das übergeordnete Fenster für ein Smartcardkennwortdialogfeld.

Hinweise

Sie können den Containernamen verwenden, um einen Schlüssel in diesem Container abzurufen.

Geben Sie einen Anbietertyp an, indem Sie einen numerischen Wert übergeben, der den gewünschten Anbietertyp darstellt. Die numerischen Werte, die die Standardanbietertypen darstellen, werden in der WinCrypt.h-Headerdatei definiert:

  • Um einen mit dem RSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 1 den dwTypeIn Parameter.

  • Um einen mit dem DSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 13 den dwTypeIn Parameter.

Informationen zu anderen Anbietertypwerten finden Sie im ProviderType Feld. Weitere Informationen zu den Standardanbietertypen und deren Verhalten finden Sie in der Dokumentation zur Microsoft Cryptography API (CAPI).

Gilt für:

CspParameters(Int32, String, String, CryptoKeySecurity, SecureString)

Initialisiert eine neue Instanz der CspParameters Klasse mit einem Anbietertyp, einem Anbieternamen, einem Containernamen, Zugriffsinformationen und einem Kennwort, das einem Smartcardschlüssel zugeordnet ist.

public:
 CspParameters(int providerType, System::String ^ providerName, System::String ^ keyContainerName, System::Security::AccessControl::CryptoKeySecurity ^ cryptoKeySecurity, System::Security::SecureString ^ keyPassword);
public CspParameters(int providerType, string providerName, string keyContainerName, System.Security.AccessControl.CryptoKeySecurity cryptoKeySecurity, System.Security.SecureString keyPassword);
new System.Security.Cryptography.CspParameters : int * string * string * System.Security.AccessControl.CryptoKeySecurity * System.Security.SecureString -> System.Security.Cryptography.CspParameters
Public Sub New (providerType As Integer, providerName As String, keyContainerName As String, cryptoKeySecurity As CryptoKeySecurity, keyPassword As SecureString)

Parameter

providerType
Int32

Der Anbietertypcode, der die Art des zu erstellenden Anbieters angibt.

providerName
String

Ein Anbietername.

keyContainerName
String

Ein Containername.

cryptoKeySecurity
CryptoKeySecurity

Ein Objekt, das Zugriffsrechte und Überwachungsregeln für einen Container darstellt.

keyPassword
SecureString

Ein Kennwort, das einem Smartcardschlüssel zugeordnet ist.

Hinweise

Sie können den Containernamen verwenden, um einen Schlüssel in diesem Container abzurufen.

Geben Sie einen Anbietertyp an, indem Sie einen numerischen Wert übergeben, der den gewünschten Anbietertyp darstellt. Die numerischen Werte, die die Standardanbietertypen darstellen, werden in der WinCrypt.h-Headerdatei definiert:

  • Um einen mit dem RSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 1 den dwTypeIn Parameter.

  • Um einen mit dem DSA Algorithmus kompatiblen Anbieter anzugeben, übergeben Sie einen Wert an 13 den dwTypeIn Parameter.

Informationen zu anderen Anbietertypwerten finden Sie im ProviderType Feld. Weitere Informationen zu den Standardanbietertypen und deren Verhalten finden Sie in der Dokumentation zur Microsoft Cryptography API (CAPI).

Gilt für: