CngKey.Open Methode

Definitie

Naamruimte:: System.Security.Cryptography

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Security.Cryptography.Cng.dll

Assembly's:: System.Security.Cryptography.dll, System.Security.Cryptography.Cng.dll

Assembly:: System.Core.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee maakt u een exemplaar van een CngKey object dat een bestaande sleutel vertegenwoordigt.

Overloads

Name	Description
Open(String)	Hiermee maakt u een exemplaar van een CngKey object dat een bestaande benoemde sleutel vertegenwoordigt.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Hiermee maakt u een exemplaar van een CngKey object met behulp van een ingang naar een bestaande sleutel.
Open(String, CngProvider)	Hiermee maakt u een exemplaar van een CngKey object dat een bestaande benoemde sleutel vertegenwoordigt met behulp van de opgegeven sleutelopslagprovider (KSP).
Open(String, CngProvider, CngKeyOpenOptions)	Hiermee maakt u een exemplaar van een CngKey object dat een bestaande benoemde sleutel vertegenwoordigt met behulp van de opgegeven KSP (Key Storage Provider) en opties voor sleutelopen.

Open(String)

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Hiermee maakt u een exemplaar van een CngKey object dat een bestaande benoemde sleutel vertegenwoordigt.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open(string keyName);

public static System.Security.Cryptography.CngKey Open(string keyName);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string -> System.Security.Cryptography.CngKey

static member Open : string -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String) As CngKey

Parameters

keyName: String

De naam van de sleutel.

Retouren

CngKey

Een bestaande sleutel.

Kenmerken: SupportedOSPlatformAttribute

Uitzonderingen

ArgumentNullException

keyName is null.

PlatformNotSupportedException

Cryptografie Next Generation (CNG) wordt niet ondersteund op dit systeem.

CryptographicException

Alle andere fouten.

Opmerkingen

Deze overbelasting maakt gebruik van de volgende standaardwaarden:

Sleutelopslagprovider (KSP): MicrosoftSoftwareKeyStorageProvider. Gebruik de Open(String, CngProvider) overbelasting als u een andere KSP wilt opgeven.
Opties voor openen van sleutel: CngKeyOpenOptions.None.

Van toepassing op

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Hiermee maakt u een exemplaar van een CngKey object met behulp van een ingang naar een bestaande sleutel.

public:
 static System::Security::Cryptography::CngKey ^ Open(Microsoft::Win32::SafeHandles::SafeNCryptKeyHandle ^ keyHandle, System::Security::Cryptography::CngKeyHandleOpenOptions keyHandleOpenOptions);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open(Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);

public static System.Security.Cryptography.CngKey Open(Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);

[System.Security.SecurityCritical]
public static System.Security.Cryptography.CngKey Open(Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle keyHandle, System.Security.Cryptography.CngKeyHandleOpenOptions keyHandleOpenOptions);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

[<System.Security.SecurityCritical>]
static member Open : Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle * System.Security.Cryptography.CngKeyHandleOpenOptions -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyHandle As SafeNCryptKeyHandle, keyHandleOpenOptions As CngKeyHandleOpenOptions) As CngKey

Parameters

keyHandle: SafeNCryptKeyHandle

Een ingang naar een bestaande sleutel.

keyHandleOpenOptions: CngKeyHandleOpenOptions

Een van de opsommingswaarden die aangeeft of keyHandle een kortstondige sleutel of een benoemde sleutel vertegenwoordigt.

Retouren

CngKey

Een bestaande sleutel.

Kenmerken: SupportedOSPlatformAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentNullException

keyHandle is null.

ArgumentException

keyHandle is ongeldig of ongeldig, of is al gesloten. Deze uitzondering wordt ook gegenereerd als de sleutel een tijdelijke sleutel is die wordt gemaakt door de Common Language Runtime (CLR), maar de EphemeralKey waarde niet is opgegeven.

PlatformNotSupportedException

Cryptografie Next Generation (CNG) wordt niet ondersteund op dit systeem.

CryptographicException

Alle andere fouten.

Opmerkingen

Dankzij deze overbelasting kunnen geavanceerde gebruikers de CNG-klassen gebruiken, zelfs als ze afhankelijk zijn van platform-aanroepen of de beheerde interoperabiliteitsmogelijkheid van C++. Als u bijvoorbeeld een systeemeigen bibliotheek hebt die de sleutel retourneert als een NCRYPT_KEY_HANDLE, kunt u met deze overbelasting een beheerde wrapper rond de sleutel maken en de CNG-klassen gebruiken om deze te bewerken.

Wanneer u een sleutel opent met behulp van de greep, kunt u de tijdelijke status van de sleutel niet bepalen en moet u deze zelf opgeven. Verschillende eigenschappen van de CngKey klasse zijn afhankelijk van deze waarde om correct te zijn. Zorg er daarom voor dat u de juiste vlagwaarde doorgeeft aan de Open methoden.

Van toepassing op

Open(String, CngProvider)

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Hiermee maakt u een exemplaar van een CngKey object dat een bestaande benoemde sleutel vertegenwoordigt met behulp van de opgegeven sleutelopslagprovider (KSP).

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName, System::Security::Cryptography::CngProvider ^ provider);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open(string keyName, System.Security.Cryptography.CngProvider provider);

public static System.Security.Cryptography.CngKey Open(string keyName, System.Security.Cryptography.CngProvider provider);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey

static member Open : string * System.Security.Cryptography.CngProvider -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String, provider As CngProvider) As CngKey

Parameters

keyName: String

De naam van de sleutel.

provider: CngProvider

De KSP die de sleutel bevat.

Retouren

CngKey

Een bestaande sleutel.

Kenmerken: SupportedOSPlatformAttribute

Uitzonderingen

ArgumentNullException

keyName of provider is null.

PlatformNotSupportedException

Cryptografie Next Generation (CNG) wordt niet ondersteund op dit systeem.

CryptographicException

Alle andere fouten.

Opmerkingen

In tegenstelling tot de overbelasting van de Open(String) methode kunt u met deze overbelasting de provider opgeven. Daarnaast wordt er een standaardwaarde CngKeyOpenOptions van None gemaakt en gebonden aan de sleutel.

Van toepassing op

Open(String, CngProvider, CngKeyOpenOptions)

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Bron:: Cng.NotSupported.cs

Hiermee maakt u een exemplaar van een CngKey object dat een bestaande benoemde sleutel vertegenwoordigt met behulp van de opgegeven KSP (Key Storage Provider) en opties voor sleutelopen.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::String ^ keyName, System::Security::Cryptography::CngProvider ^ provider, System::Security::Cryptography::CngKeyOpenOptions openOptions);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.Security.Cryptography.CngKey Open(string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);

public static System.Security.Cryptography.CngKey Open(string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);

[System.Security.SecurityCritical]
public static System.Security.Cryptography.CngKey Open(string keyName, System.Security.Cryptography.CngProvider provider, System.Security.Cryptography.CngKeyOpenOptions openOptions);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

[<System.Security.SecurityCritical>]
static member Open : string * System.Security.Cryptography.CngProvider * System.Security.Cryptography.CngKeyOpenOptions -> System.Security.Cryptography.CngKey

Public Shared Function Open (keyName As String, provider As CngProvider, openOptions As CngKeyOpenOptions) As CngKey

Parameters

keyName: String

De naam van de sleutel.

provider: CngProvider

De KSP die de sleutel bevat.

openOptions: CngKeyOpenOptions

Een bitsgewijze combinatie van de opsommingswaarden waarmee opties worden opgegeven voor het openen van de sleutel, zoals waar de sleutel wordt geopend (machine- of gebruikersopslag) en of u de gebruikersinterfaceprompt wilt onderdrukken.

Retouren

CngKey

Een bestaande sleutel.

Kenmerken: SupportedOSPlatformAttribute SecurityCriticalAttribute

Uitzonderingen

ArgumentNullException

keyName of provider is null.

PlatformNotSupportedException

Cryptografie Next Generation (CNG) wordt niet ondersteund op dit systeem.

CryptographicException

Alle andere fouten.

Opmerkingen

In tegenstelling tot de overbelasting van de Open(String) methode kunt u met deze overbelasting zowel de provider als de opties voor openen van sleutels opgeven.

Van toepassing op

Feedback

Is deze pagina nuttig?