Método PrivateKey.Open

[O método Open está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Em vez disso, use a propriedade X509Certificate2.PrivateKey no namespace System.Security.Cryptography.X509Certificates .]

O método Open acessa um contêiner de chaves existente. Esse método associa o contêiner de chave ao certificado que corresponde à chave privada adicionando a propriedade CERT_KEY_PROV_INFO_PROP_ID usando as informações especificadas.

Sintaxe

PrivateKey.Open( _
  ByVal ContainerName, _
  [ ByVal ProviderName ], _
  [ ByVal ProviderType ], _
  [ ByVal KeySpec ], _
  [ ByVal StoreLocation ], _
  [ ByVal bCheckExistence ] _
)

Parâmetros

ContainerName [in]

Uma cadeia de caracteres que contém o nome do contêiner de chave.

ProviderName [in, opcional]

Uma cadeia de caracteres que contém o nome do provedor. O valor padrão é CAPICOM_PROV_MS_ENHANCED_PROV. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_PROV_MS_DEF_PROV	Provedor criptográfico base da Microsoft.
CAPICOM_PROV_MS_ENHANCED_PROV	Provedor criptográfico aprimorado da Microsoft.
CAPICOM_PROV_MS_STRONG_PROV	Provedor criptográfico forte da Microsoft.
CAPICOM_PROV_MS_DEF_RSA_SIG_PROV	Provedor criptográfico de assinatura do Microsoft RSA.
CAPICOM_PROV_MS_DEF_RSA_SCHANNEL_PROV	Provedor criptográfico do Microsoft RSA Schannel.
CAPICOM_PROV_MS_DEF_DSS_PROV	Provedor criptográfico de DSS base da Microsoft.
CAPICOM_PROV_MS_DEF_DSS_DH_PROV	O DSS de base da Microsoft e Diffie-Hellman provedor criptográfico.
CAPICOM_PROV_MS_ENH_DSS_DH_PROV	O DSS aprimorado da Microsoft e Diffie-Hellman provedor criptográfico.
CAPICOM_PROV_MS_DEF_DH_SCHANNEL_PROV	Provedor criptográfico do Microsoft DH Schannel.
CAPICOM_PROV_MS_SCARD_PROV	Provedor criptográfico de cartão inteligente da Microsoft base.
CAPICOM_PROV_MS_ENH_RSA_AES_PROV	Provedor criptográfico RSA e AES aprimorado da Microsoft.

 

ProviderType [in, opcional]

Um valor da enumeração CAPICOM_PROV_TYPE que especifica um tipo de provedor. O valor padrão é CAPICOM_PROV_RSA_FULL. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_PROV_RSA_FULL	O CSP (provedor de serviço criptográfico) RSA completo. Esse tipo de provedor dá suporte a assinaturas digitais e criptografia de dados.
CAPICOM_PROV_RSA_SIG	O subconjunto do CSP RSA que dá suporte apenas às funções e algoritmos necessários para hashes e assinaturas digitais.
CAPICOM_PROV_DSS	O CSP padrão de assinatura digital (DSS). Esse tipo de provedor dá suporte apenas a hashes e assinaturas digitais. O DSS usa o DSA ( Algoritmo de Assinatura Digital ).
CAPICOM_PROV_FORTEZZA	O CSP que contém os protocolos criptográficos e algoritmos pertencentes ao NIST (National Institute of Standards and Technology ).
CAPICOM_PROV_MS_EXCHANGE	O CSP que dá suporte ao aplicativo de email do Microsoft Exchange e a outros aplicativos compatíveis com o Microsoft Mail.
CAPICOM_PROV_SSL	O CSP que dá suporte ao protocolo SSL ( Secure Sockets Layer ).
CAPICOM_PROV_RSA_SCHANNEL	O CSP que dá suporte a protocolos RSA e Schannel .
CAPICOM_PROV_DSS_DH	O CSP que dá suporte aos protocolos DSS e Diffie-Hellman .
CAPICOM_PROV_EC_ECDSA_SIG	O CSP que dá suporte às funções e algoritmos ECDSA (Algoritmo de Assinatura Digital de Curva Elíptica) necessários para assinaturas digitais.
CAPICOM_PROV_EC_ECNRA_SIG	O CSP que dá suporte às funções e algoritmos ECNRA (curva elíptic Nyberg-Rueppel a) necessárias para assinaturas digitais.
CAPICOM_PROV_EC_ECDSA_FULL	O CSP que dá suporte à ECDSA completa.
CAPICOM_PROV_EC_ECNRA_FULL	O CSP que dá suporte ao ECNRA completo.
CAPICOM_PROV_DH_SCHANNEL	O CSP que dá suporte aos protocolos Diffie-Hellman e Schannel .
CAPICOM_PROV_SPYRUS_LYNKS	O CSP que dá suporte ao dispositivo SPYRUS LYNKS Card.
CAPICOM_PROV_RNG	O CSP que manipula a geração de números aleatórios.
CAPICOM_PROV_INTEL_SEC	O CSP que fornece segurança intel.
CAPICOM_PROV_REPLACE_OWF	O CSP que dá suporte à substituição da maneira como os formatos unidirecionais são gerados a partir de senhas.
CAPICOM_PROV_RSA_AES	O CSP que dá suporte a assinaturas digitais e criptografia de dados usando o algoritmo AES (Advanced Encryption Standard).

 

KeySpec [in, opcional]

Um valor da enumeração CAPICOM_KEY_SPEC que especifica o tipo de chave privada. O valor padrão é CAPICOM_KEY_SPEC_SIGNATURE. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_KEY_SPEC_KEYEXCHANGE	A chave pode ser usada para criptografia e assinatura.
CAPICOM_KEY_SPEC_SIGNATURE	A chave só pode ser usada para assinatura.

 

StoreLocation [in, opcional]

Um valor da enumeração CAPICOM_STORE_LOCATION que especifica o local do repositório em que a chave reside. O valor padrão é CAPICOM_CURRENT_USER_STORE. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_MEMORY_STORE	O repositório é um repositório de memória. As alterações no conteúdo do repositório não são mantidas.
CAPICOM_LOCAL_MACHINE_STORE	O repositório é um repositório de computadores local. Os repositórios de computadores locais só poderão ser repositórios de leitura/gravação se o usuário tiver permissões de leitura/gravação. Se o usuário tiver permissões de leitura/gravação e se o repositório estiver aberto de leitura/gravação, as alterações no conteúdo do repositório serão mantidas.
CAPICOM_CURRENT_USER_STORE	O repositório é um repositório de usuários atual. Um repositório de usuários atual pode ser um repositório de leitura/gravação. Se for, as alterações no conteúdo do repositório serão mantidas.
CAPICOM_ACTIVE_DIRECTORY_USER_STORE	O repositório é um repositório do Active Directory. Os repositórios do Active Directory só podem ser abertos no modo somente leitura. Os certificados não podem ser adicionados ou removidos dos repositórios do Active Directory.
CAPICOM_SMART_CARD_USER_STORE	A loja é o grupo de cartões inteligentes presentes. Introduzido no CAPICOM 2.0.

 

bCheckExistence [in, opcional]

Um valor booliano que indica se CAPICOM tentará acessar a chave. Se True, CAPICOM tentará acessar a chave. Se a chave estiver protegida pelo usuário ou em um cartão inteligente ou em outro dispositivo, uma caixa de diálogo poderá ser gerada. O valor padrão é Falso.

Valor retornado

Esse método não retorna um valor.

Comentários

Esse método retorna CAPICOM_E_NOT_ALLOWED quando é gerado um script de um aplicativo baseado na Web.

Requisitos

Confira também

Privatekey

Certificate.HasPrivateKey