CngKey.Open Metod

Definition

Namnområde:: System.Security.Cryptography

Sammansättning:: System.Security.Cryptography.dll

Sammansättning:: System.Security.Cryptography.Cng.dll

Sammansättningar:: System.Security.Cryptography.dll, System.Security.Cryptography.Cng.dll

Sammansättning:: System.Core.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en instans av ett CngKey objekt som representerar en befintlig nyckel.

Överlagringar

Name	Description
Open(String)	Skapar en instans av ett CngKey objekt som representerar en befintlig namngiven nyckel.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Skapar en instans av ett CngKey objekt med hjälp av ett handtag till en befintlig nyckel.
Open(String, CngProvider)	Skapar en instans av ett CngKey objekt som representerar en befintlig namngiven nyckel med hjälp av den angivna nyckellagringsprovidern (KSP).
Open(String, CngProvider, CngKeyOpenOptions)	Skapar en instans av ett CngKey objekt som representerar en befintlig namngiven nyckel med hjälp av de angivna alternativen nyckellagringsprovider (KSP) och nyckelöppning.

Open(String)

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Skapar en instans av ett CngKey objekt som representerar en befintlig namngiven nyckel.

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

Parametrar

keyName: String

Namnet på nyckeln.

Returer

CngKey

En befintlig nyckel.

Attribut: SupportedOSPlatformAttribute

Undantag

ArgumentNullException

keyName är null.

PlatformNotSupportedException

Kryptografi nästa generation (CNG) stöds inte i det här systemet.

CryptographicException

Alla andra fel.

Kommentarer

Den här överlagringen använder följande standardvärden:

Nyckellagringsprovider (KSP): MicrosoftSoftwareKeyStorageProvider. Använd överlagringen Open(String, CngProvider) om du vill ange en annan KSP.
Alternativ för nyckelöppning: CngKeyOpenOptions.None.

Gäller för

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Skapar en instans av ett CngKey objekt med hjälp av ett handtag till en befintlig nyckel.

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

Parametrar

keyHandle: SafeNCryptKeyHandle

Ett handtag till en befintlig nyckel.

keyHandleOpenOptions: CngKeyHandleOpenOptions

Ett av uppräkningsvärdena som anger om keyHandle representerar en tillfällig nyckel eller en namngiven nyckel.

Returer

CngKey

En befintlig nyckel.

Attribut: SupportedOSPlatformAttribute SecurityCriticalAttribute

Undantag

ArgumentNullException

keyHandle är null.

ArgumentException

keyHandle är ogiltigt eller felaktigt, eller så är det redan stängt. Det här undantaget utlöses också om nyckeln är en tillfällig nyckel som skapas av CLR (Common Language Runtime), men EphemeralKey värdet har inte angetts.

PlatformNotSupportedException

Kryptografi nästa generation (CNG) stöds inte i det här systemet.

CryptographicException

Alla andra fel.

Kommentarer

Den här överlagringen gör det möjligt för avancerade användare att använda CNG-klasserna även om de förlitar sig på plattformsanrop eller den hanterade interop-funktionen för C++. Om du till exempel har ett inbyggt bibliotek som returnerar nyckeln som en NCRYPT_KEY_HANDLE kan du med den här överlagringen skapa en hanterad omslutning runt nyckeln och använda CNG-klasserna för att ändra den.

När du öppnar en nyckel med hjälp av dess handtag kan du inte fastställa nyckelns tillfälliga tillstånd och måste ange den själv. Flera egenskaper för CngKey klassen förlitar sig på att det här värdet är korrekt. Kontrollera därför att du skickar rätt flaggvärde till Open metoderna.

Gäller för

Open(String, CngProvider)

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Skapar en instans av ett CngKey objekt som representerar en befintlig namngiven nyckel med hjälp av den angivna nyckellagringsprovidern (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

Parametrar

keyName: String

Namnet på nyckeln.

provider: CngProvider

Den KSP som innehåller nyckeln.

Returer

CngKey

En befintlig nyckel.

Attribut: SupportedOSPlatformAttribute

Undantag

ArgumentNullException

keyName eller provider är null.

PlatformNotSupportedException

Kryptografi nästa generation (CNG) stöds inte i det här systemet.

CryptographicException

Alla andra fel.

Kommentarer

Till skillnad från metodöverlagringen Open(String) kan du ange providern med den här överlagringen. Dessutom skapas ett standardvärde CngKeyOpenOptions None för och är bundet till nyckeln.

Gäller för

Open(String, CngProvider, CngKeyOpenOptions)

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Källa:: Cng.NotSupported.cs

Skapar en instans av ett CngKey objekt som representerar en befintlig namngiven nyckel med hjälp av de angivna alternativen nyckellagringsprovider (KSP) och nyckelöppning.

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

Parametrar

keyName: String

Namnet på nyckeln.

provider: CngProvider

Den KSP som innehåller nyckeln.

openOptions: CngKeyOpenOptions

En bitvis kombination av uppräkningsvärdena som anger alternativ för att öppna nyckeln, till exempel var nyckeln öppnas från (dator eller användarlagring) och om användargränssnittet ska frågas ut.

Returer

CngKey

En befintlig nyckel.

Attribut: SupportedOSPlatformAttribute SecurityCriticalAttribute

Undantag

ArgumentNullException

keyName eller provider är null.

PlatformNotSupportedException

Kryptografi nästa generation (CNG) stöds inte i det här systemet.

CryptographicException

Alla andra fel.

Kommentarer

Till skillnad från metodöverlagringen Open(String) kan du med den här överlagringen ange både providern och alternativen för nyckelöppning.

Gäller för

Feedback

Var den här sidan till hjälp?