Método ICertificate2::Load

[CAPICOM é um componente somente de 32 bits que está disponível para uso nos seguintes sistemas operacionais: Windows Server 2008, Windows Vista e Windows XP. Em vez disso, use a classe X509Certificate2 no namespace System.Security.Cryptography.X509Certificates .]

O método Load importa um certificado de um arquivo. Esse método foi introduzido no CAPICOM 2.0.

Sintaxe

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

Parâmetros

FileName [in]

Uma cadeia de caracteres que contém o caminho para um arquivo .cer ou .pfx que contém os dados do certificado.

Senha [in, opcional]

Uma cadeia de caracteres que contém a senha de texto sem formatação para o arquivo de chave privada . A senha pode conter até 32 caracteres Unicode, incluindo um caractere nulo de terminação. 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. A tabela a seguir mostra os valores possíveis.

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.

 

KeyLocation [in, opcional]

Um valor da enumeração CAPICOM_KEY_LOCATION que define tipos de localização de chave. O valor padrão é CAPICOM_CURRENT_USER_KEY. A tabela a seguir mostra os valores possíveis.

Valor	Significado
CAPICOM_CURRENT_USER_KEY	A chave é uma chave de usuário.
CAPICOM_LOCAL_MACHINE_KEY	A chave é uma chave de computador.

 

Valor retornado

Esse método não retorna um valor.

Comentários

Esse método gera CAPICOM_E_NOT_ALLOWED quando é roteirizado de um aplicativo baseado na Web.

Requisitos

Requisito	Valor
Fim do suporte ao cliente	Windows Vista
Fim do suporte ao servidor	Windows Server 2008
Redistribuível	CAPICOM 2.0 ou posterior no Windows Server 2003 e Windows XP
DLL	Capicom.dll