CngKey.Open Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Security.Cryptography

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

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Core.dll

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

Pacchetto:: System.Security.Cryptography.Cng v5.0.0

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea un'istanza di un oggetto CngKey che rappresenta una chiave esistente.

Overload

Open(String)	Crea un'istanza di un oggetto CngKey che rappresenta una chiave denominata esistente.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Crea un'istanza di un oggetto CngKey utilizzando un handle per una chiave esistente.
Open(String, CngProvider)	Crea un'istanza di un oggetto CngKey che rappresenta una chiave denominata esistente, utilizzando il provider di archiviazione chiavi (KSP) specificato.
Open(String, CngProvider, CngKeyOpenOptions)	Crea un'istanza di un oggetto CngKey che rappresenta una chiave denominata esistente, utilizzando il provider di archiviazione chiavi (KSP) e le opzioni di apertura della chiave specificati.

Open(String)

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Crea un'istanza di un oggetto CngKey che rappresenta una chiave denominata esistente.

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

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

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

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

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

Public Shared Function Open (keyName As String) As CngKey

Parametri

keyName: String

Nome della chiave.

Restituisce

CngKey

Chiave esistente.

Attributi: SupportedOSPlatformAttribute

Eccezioni

ArgumentNullException

keyName è null.

PlatformNotSupportedException

Cryptography Next Generation non è supportato in questo sistema.

CryptographicException

Tutti gli altri errori.

Commenti

Questo overload usa le impostazioni predefinite seguenti:

Provider di archiviazione chiavi (KSP): MicrosoftSoftwareKeyStorageProvider. Usare l'overload Open(String, CngProvider) se si vuole specificare un altro provider di servizi di configurazione.
Opzioni di apertura chiave: CngKeyOpenOptions.None.

Si applica a

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Crea un'istanza di un oggetto CngKey utilizzando un handle per una chiave esistente.

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.Runtime.Versioning.SupportedOSPlatform("windows")]
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);

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

Parametri

keyHandle: SafeNCryptKeyHandle

Handle per una chiave esistente.

keyHandleOpenOptions: CngKeyHandleOpenOptions

Uno dei valori di enumerazione che indica se l'oggetto keyHandle rappresenta una chiave effimera o una chiave denominata.

Restituisce

CngKey

Chiave esistente.

Attributi: SupportedOSPlatformAttribute SecurityCriticalAttribute

Eccezioni

ArgumentNullException

keyHandle è null.

ArgumentException

keyHandle è non valido o in formato non corretto, oppure è già chiuso. Questa eccezione viene inoltre generata se la chiave è una chiave effimera creata da Common Language Runtime (CLR), ma il valore EphemeralKey non viene specificato.

PlatformNotSupportedException

Cryptography Next Generation non è supportato in questo sistema.

CryptographicException

Tutti gli altri errori.

Commenti

Questo overload consente agli utenti avanzati di usare le classi CNG anche se si basano su platform invoke o sulla funzionalità di interoperabilità gestita di C++. Ad esempio, se si dispone di una libreria nativa che restituisce la chiave come NCRYPT_KEY_HANDLE, questo overload consente di creare un wrapper gestito intorno alla chiave e di usare le classi CNG per modificarla.

Quando si apre una chiave usando il relativo handle, non è possibile determinare lo stato temporaneo della chiave e specificarlo manualmente. Diverse proprietà della CngKey classe si basano su questo valore per essere corrette. Assicurarsi quindi di passare il valore del flag corretto ai Open metodi .

Si applica a

Open(String, CngProvider)

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Crea un'istanza di un oggetto CngKey che rappresenta una chiave denominata esistente, utilizzando il provider di archiviazione chiavi (KSP) specificato.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::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")]
public static System.Security.Cryptography.CngKey Open (string keyName, System.Security.Cryptography.CngProvider provider);

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

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

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

Parametri

keyName: String

Nome della chiave.

provider: CngProvider

Provider archiviazione chiavi che contiene la chiave.

Restituisce

CngKey

Chiave esistente.

Attributi: SupportedOSPlatformAttribute

Eccezioni

ArgumentNullException

keyName o provider è null.

PlatformNotSupportedException

Cryptography Next Generation non è supportato in questo sistema.

CryptographicException

Tutti gli altri errori.

Commenti

A differenza dell'overload del Open(String) metodo, questo overload consente di specificare il provider. Viene inoltre creato un valore predefinito CngKeyOpenOptions di None e associato alla chiave.

Si applica a

Open(String, CngProvider, CngKeyOpenOptions)

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Origine:: Cng.NotSupported.cs

Crea un'istanza di un oggetto CngKey che rappresenta una chiave denominata esistente, utilizzando il provider di archiviazione chiavi (KSP) e le opzioni di apertura della chiave specificati.

public:
 static System::Security::Cryptography::CngKey ^ Open(System::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.Runtime.Versioning.SupportedOSPlatform("windows")]
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);

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

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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

Parametri

keyName: String

Nome della chiave.

provider: CngProvider

Provider archiviazione chiavi che contiene la chiave.

openOptions: CngKeyOpenOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni di apertura della chiave, ad esempio se la chiave viene aperta dal computer o dall'archivio utente e se eliminare il prompt dell'interfaccia utente.

Restituisce

CngKey

Chiave esistente.

Attributi: SupportedOSPlatformAttribute SecurityCriticalAttribute

Eccezioni

ArgumentNullException

keyName o provider è null.

PlatformNotSupportedException

Cryptography Next Generation non è supportato in questo sistema.

CryptographicException

Tutti gli altri errori.

Commenti

A differenza dell'overload del Open(String) metodo, questo overload consente di specificare sia il provider che le opzioni di apertura della chiave.

Si applica a

Condividi tramite

CngKey.Open Metodo

Definizione

Overload

Open(String)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Open(String, CngProvider)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Open(String, CngProvider, CngKeyOpenOptions)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Risorse aggiuntive