Método Store.Load

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

O método Load importa certificados de um arquivo para o repositório.

Sintaxe

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

Parâmetros

FileName [in]

A cadeia de caracteres que contém o caminho para um arquivo .cer, .sst, .spc, .p7s ou .pfx ou qualquer arquivo assinado authenticode.

Senha [in, opcional]

A cadeia de caracteres que contém a senha de texto não criptografado para o arquivo. Até 32 caracteres Unicode, incluindo um caractere nulo de terminação, podem ser usados para a senha. Para obter informações sobre como proteger a senha, consulte Manipulando senhas.

KeyStorageFlag [in, opcional]

Um valor da enumeração CAPICOM_KEY_STORAGE_FLAG que define sinalizadores de armazenamento de chaves. O padrão é CAPICOM_KEY_STORAGE_DEFAULT. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CAPICOM_KEY_STORAGE_DEFAULT	Armazenamento de chaves padrão.
CAPICOM_KEY_STORAGE_EXPORTABLE	A chave é exportável.
CAPICOM_KEY_STORAGE_USER_PROTECTED	A chave é protegida pelo usuário.

 

Valor retornado

Esse método não retorna um valor.

Comentários

Se o método Load for chamado em um repositório de memória, todos os contêineres de chave criados serão excluídos quando o repositório de memória for excluído. Por exemplo, se um arquivo .pfx for carregado em um repositório de memória e posteriormente adicionado a um repositório do sistema (como o Meu repositório) do repositório de memória, o certificado no Meu repositório não conterá uma chave. Nesse caso, o arquivo .pfx deve ser carregado diretamente no Meu repositório.

Esse método gera CAPICOM_E_NOT_ALLOWED quando ele é gerado por script de um aplicativo baseado na Web.

Se a senha não conseguir descriptografar o arquivo de chave privada, o CSP ( provedor de serviços criptográficos ) padrão deverá ser consultado. Se o CSP padrão for o Provedor Criptográfico Base da Microsoft e a operação de descriptografar falhar, a operação de descriptografar deverá ser tentada novamente com o Provedor Criptográfico Forte da Microsoft ou o Provedor Criptográfico Avançado da Microsoft, o que estiver disponível.

Se o certificado que está sendo carregado no repositório for o mesmo que já está lá, o método Load excluirá o certificado existente do repositório e adicionará o novo certificado. O novo certificado herdará propriedades do certificado existente. O contêiner de chave privada existente é substituído pelo novo contêiner de chave privada.

Requisitos

Requisito	Valor
Redistribuível	CAPICOM 2.0 ou posterior no Windows Server 2003 e Windows XP
DLL	Capicom.dll

Confira também

Repositório