Método Certificates.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 X509Certificate2Collection no namespace System.Security.Cryptography.X509Certificates .]

O método Save salva os objetos Certificate na coleção.

Sintaxe

Certificates.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal ExportFlag ] _
)

Parâmetros

FileName [in]

Uma cadeia de caracteres que contém o nome do arquivo de saída em que os certificados serão salvos.

Senha [in, opcional]

Uma cadeia de caracteres que contém a senha de texto sem formatação para um arquivo de chave privada . O valor padrão é a cadeia de caracteres vazia (""). 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 Como lidar com senhas.

SaveAs [in, opcional]

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

Valor	Significado
CAPICOM_CERTIFICATES_SAVE_AS_PFX	Os certificados são salvos como um PFX.
CAPICOM_CERTIFICATES_SAVE_AS_PKCS7	Os certificados são salvos como um PKCS nº 7.
CAPICOM_CERTIFICATES_SAVE_AS_SERIALIZED	Os certificados são salvos como serializados.

 

ExportFlag [in, opcional]

Um valor da enumeração CAPICOM_EXPORT_FLAG que especifica se os erros de exportação de chave privada são ignorados. O padrão é CAPICOM_EXPORT_DEFAULT. A tabela a seguir mostra os valores possíveis.

Valor	Significado
CAPICOM_EXPORT_DEFAULT	Erros de exportação de chave privada não são ignorados.
CAPICOM_EXPORT_IGNORE_PRIVATE_KEY_NOT_EXPORTABLE_ERROR	Erros de exportação de chave privada são ignorados.

 

Valor retornado

Esse método não retorna um valor.

Comentários

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

Os objetos Certificate podem ser recuperados usando o método Store.Load .

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

Confira também

Certificados