CngKey.Open Método

Definição

Espaço de Nomes:: System.Security.Cryptography

Assemblagem:: System.Security.Cryptography.dll

Assemblagem:: System.Security.Cryptography.Cng.dll

Assemblagens:: System.Security.Cryptography.dll, System.Security.Cryptography.Cng.dll

Assemblagem:: System.Core.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
Open(String)	Cria uma instância de um CngKey objeto que representa uma chave nomeada existente.
Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)	Cria uma instância de um CngKey objeto usando um handle para uma chave existente.
Open(String, CngProvider)	Cria uma instância de um CngKey objeto que representa uma chave nomeada existente, usando o fornecedor de armazenamento de chaves (KSP) especificado.
Open(String, CngProvider, CngKeyOpenOptions)	Cria uma instância de um CngKey objeto que representa uma chave nomeada existente, utilizando as opções especificadas de fornecedor de armazenamento de chaves (KSP) e de abertura de chaves.

Open(String)

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

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

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

Parâmetros

keyName: String

O nome da chave.

Devoluções

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute

Exceções

ArgumentNullException

keyName é null.

PlatformNotSupportedException

A Criptografia de Nova Geração (CNG) não é suportada neste sistema.

CryptographicException

Todos os outros erros.

Observações

Esta sobrecarga utiliza os seguintes predefinidos:

Fornecedor de armazenamento de chaves (KSP): MicrosoftSoftwareKeyStorageProvider. Usa a Open(String, CngProvider) sobrecarga se quiseres especificar outro KSP.
Principais opções abertas: CngKeyOpenOptions.None.

Aplica-se a

Open(SafeNCryptKeyHandle, CngKeyHandleOpenOptions)

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

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

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

Parâmetros

keyHandle: SafeNCryptKeyHandle

Uma alavanca para uma chave existente.

keyHandleOpenOptions: CngKeyHandleOpenOptions

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

Devoluções

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

keyHandle é null.

ArgumentException

keyHandle é inválida ou deformada, ou já está encerrada. Esta exceção também é lançada se a chave for uma chave efémera criada pelo common language runtime (CLR), mas o EphemeralKey valor não for especificado.

PlatformNotSupportedException

A Criptografia de Nova Geração (CNG) não é suportada neste sistema.

CryptographicException

Todos os outros erros.

Observações

Esta sobrecarga permite que utilizadores avançados utilizem as classes CNG mesmo que dependam do invoke de plataforma ou da capacidade de interoperabilidade gerida do C++. Por exemplo, se tiver uma biblioteca nativa que devolve a chave como NCRYPT_KEY_HANDLE, esta sobrecarga permite-lhe criar um wrapper gerido à volta da chave e usar as classes CNG para a manipular.

Quando se abre uma chave usando a sua alavanca, não se pode determinar o estado efémero da chave e tem de o especificar por si próprio. Várias propriedades da CngKey classe dependem da correção deste valor. Por isso, certifique-se de que passa o valor de flag correto aos Open métodos.

Aplica-se a

Open(String, CngProvider)

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

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

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

Parâmetros

keyName: String

O nome da chave.

provider: CngProvider

O KSP que contém a chave.

Devoluções

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute

Exceções

ArgumentNullException

keyName ou provider é null.

PlatformNotSupportedException

A Criptografia de Nova Geração (CNG) não é suportada neste sistema.

CryptographicException

Todos os outros erros.

Observações

Ao contrário da Open(String) sobrecarga de métodos, esta sobrecarga permite especificar o fornecedor. 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

Origem:: Cng.NotSupported.cs

Origem:: Cng.NotSupported.cs

Cria uma instância de um CngKey objeto que representa uma chave nomeada existente, utilizando as opções especificadas de fornecedor de armazenamento de chaves (KSP) e de abertura de chaves.

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

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 o local de onde a chave é aberta (armazenamento da máquina ou do utilizador) e se deve suprimir o prompting da interface.

Devoluções

CngKey

Uma chave existente.

Atributos: SupportedOSPlatformAttribute SecurityCriticalAttribute

Exceções

ArgumentNullException

keyName ou provider é null.

PlatformNotSupportedException

A Criptografia de Nova Geração (CNG) não é suportada neste sistema.

CryptographicException

Todos os outros erros.

Observações

Ao contrário da Open(String) sobrecarga de métodos, esta sobrecarga permite especificar tanto a opção de abertura do fornecedor como da chave.

Aplica-se a

Comentários

Esta página foi útil?