CngKey.Open Método

Referência

Definição

Namespace:: System.Security.Cryptography

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

Assembly:: System.Security.Cryptography.dll

Assembly:: System.Core.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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)

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

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute

Exceções

ArgumentNullException

keyName é null.

PlatformNotSupportedException

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

CryptographicException

Todos os outros erros.

Comentários

Essa sobrecarga usa os seguintes padrões:

KSP (provedor de armazenamento de chaves): MicrosoftSoftwareKeyStorageProvider. Use a Open(String, CngProvider) sobrecarga se quiser especificar outro KSP.
Opções de abertura de chave: CngKeyOpenOptions.None.

Aplica-se a

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

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

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

keyHandle é null.

ArgumentException

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.

PlatformNotSupportedException

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

CryptographicException

Todos os outros erros.

Comentários

Essa sobrecarga permite que os usuários avançados usem as classes CNG mesmo que eles confiem na invocação da plataforma ou na 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 em torno 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 estarem corretas. Portanto, certifique-se de passar o valor correto do sinalizador para os Open métodos.

Aplica-se a

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.

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

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute

Exceções

ArgumentNullException

keyName ou provider é null.

PlatformNotSupportedException

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

CryptographicException

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 None padrão CngKeyOpenOptions é criado e associado à chave.

Aplica-se a

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.

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

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

keyName ou provider é null.

PlatformNotSupportedException

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

CryptographicException

Todos os outros erros.

Comentários

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

Aplica-se a

CngKey.Open Método

Definição

Sobrecargas

Open(String)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Open(String, CngProvider)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Open(String, CngProvider, CngKeyOpenOptions)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Recursos adicionais