Partilhar via


CngKey.Open Método

Definição

Cria uma instância de um objeto CngKey que representa uma chave existente.

Sobrecargas

Open(String)

Cria uma instância de um objeto CngKey que representa uma chave nomeada existente.

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Cria uma instância de um objeto CngKey usando um identificador para uma chave existente.

Open(String, CngProvider)

Cria uma instância de um objeto CngKey que representa uma chave nomeada existente, usando o KSP (provedor de armazenamento de chaves) especificado.

Open(String, CngProvider, CngKeyOpenOptions)

Cria uma instância de um objeto CngKey que representa uma chave nomeada existente, usando o KSP (provedor de armazenamento de chaves) e as opções de abertura da chave especificados.

Open(String)

Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs

Cria uma instância de um objeto CngKey que representa uma chave nomeada existente.

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

Parâmetros

keyName
String

O nome da chave.

Retornos

Uma chave existente.

Atributos

Exceções

keyName é null.

A CNG (Cryptography Next Generation) não é compatível com este sistema.

Todos os outros erros.

Comentários

Essa sobrecarga usa os seguintes padrões:

Aplica-se a

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs

Cria uma instância de um objeto CngKey usando um identificador para uma chave existente.

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

Parâmetros

keyHandle
SafeNCryptKeyHandle

Um identificador para uma chave existente.

keyHandleOpenOptions
CngKeyHandleOpenOptions

Um dos valores de enumeração que indica se keyHandle representa uma chave efêmera ou uma chave nomeada.

Retornos

Uma chave existente.

Atributos

Exceções

keyHandle é null.

keyHandle é inválido ou mal formado ou já está fechado. Essa exceção também será gerada se a chave for uma chave efêmera criada pelo CLR (Common Language Runtime), mas o valor EphemeralKey não for especificado.

A CNG (Cryptography Next Generation) não é compatível com este sistema.

Todos os outros erros.

Comentários

Essa sobrecarga permite que os usuários avançados usem as classes CNG mesmo que eles dependam da invocação da plataforma ou da funcionalidade de interoperabilidade gerenciada do C++. Por exemplo, se você tiver uma biblioteca nativa que retorna a chave como um NCRYPT_KEY_HANDLE, essa sobrecarga permitirá que você crie um wrapper gerenciado ao redor da chave e use as classes CNG para manipulá-la.

Ao abrir uma chave usando seu identificador, não é possível determinar o estado efêmero da chave e especifique-a por conta própria. Várias propriedades da CngKey classe dependem desse valor para estar correto. Portanto, certifique-se de passar o valor do sinalizador correto para os Open métodos.

Aplica-se a

Open(String, CngProvider)

Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs

Cria uma instância de um objeto CngKey que representa uma chave nomeada existente, usando o KSP (provedor de armazenamento de chaves) especificado.

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

Parâmetros

keyName
String

O nome da chave.

provider
CngProvider

O KSP que contém a chave.

Retornos

Uma chave existente.

Atributos

Exceções

keyName ou provider é null.

A CNG (Cryptography Next Generation) não é compatível com este sistema.

Todos os outros erros.

Comentários

Ao contrário da sobrecarga do Open(String) método, essa sobrecarga permite que você especifique o provedor. Além disso, um valor padrão CngKeyOpenOptions de None é criado e associado à chave.

Aplica-se a

Open(String, CngProvider, CngKeyOpenOptions)

Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs
Origem:
Cng.NotSupported.cs

Cria uma instância de um objeto CngKey que representa uma chave nomeada existente, usando o KSP (provedor de armazenamento de chaves) e as opções de abertura da chave especificados.

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

Parâmetros

keyName
String

O nome da chave.

provider
CngProvider

O KSP que contém a chave.

openOptions
CngKeyOpenOptions

Uma combinação bit a bit dos valores de enumeração que especifica opções para abrir a chave, como de onde a chave é aberta (armazenamento do usuário ou computador) e se o prompt da interface do usuário deve ser suprimido.

Retornos

Uma chave existente.

Atributos

Exceções

keyName ou provider é null.

A CNG (Cryptography Next Generation) não é compatível com este sistema.

Todos os outros erros.

Comentários

Ao contrário da sobrecarga do Open(String) método, essa sobrecarga permite que você especifique as opções de abertura do provedor e da chave.

Aplica-se a