Método ICertificate2::Save

[CAPICOM é um componente somente de 32 bits 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 Save salva o certificado em um arquivo. Esse método foi introduzido no CAPICOM 2.0.

Sintaxe

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Parâmetros

FileName [in]

Uma cadeia de caracteres que contém o nome do arquivo de saída em que o certificado será salvo.

Senha [in, opcional]

Uma cadeia de caracteres que contém a senha de texto não criptografado para um 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 Como lidar com senhas.

SaveAs [in, opcional]

Um valor da enumeração CAPICOM_CERTIFICATE_SAVE_AS_TYPE que especifica o formato do arquivo de saída. O padrão é CAPICOM_CERTIFICATE_SAVE_AS_CER. A tabela a seguir mostra os valores possíveis.

Valor	Significado
CAPICOM_CERTIFICATE_SAVE_AS_CER	O arquivo de saída será formatado como um arquivo .cer sem chaves privadas salvas.
CAPICOM_CERTIFICATE_SAVE_AS_PFX	O arquivo de saída será formatado como um arquivo .pfx (PKCS #12) e todas as chaves privadas associadas que sejam exportáveis também serão salvas.

 

IncludeOption [in, opcional]

Um valor da enumeração CAPICOM_CERTIFICATE_INCLUDE_OPTION que especifica quantos certificados na cadeia são salvos no arquivo de saída. O padrão é CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. A tabela a seguir mostra os valores possíveis.

Valor	Significado
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT	Salva todos os certificados na cadeia com exceção da entidade raiz
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN	Salva a cadeia de certificados completa
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY	Salva apenas o certificado da entidade final

 

Valor retornado

Esse método não retorna um valor.

Comentários

Esse método gera CAPICOM_E_NOT_ALLOWED quando ele é roteado 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