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 |
|