Função PFXExportCertStore (wincrypt.h)

Artigo
03/13/2024

A função PFXExportCertStore exporta os certificados e, se disponível, as chaves privadas associadas do repositório de certificados referenciado. Essa é uma função antiga mantida para compatibilidade com clientes da Internet Explorer 4.0. Novos aplicativos devem usar a função PfxExportCertStoreEx que fornece segurança de chave privada aprimorada.

Sintaxe

BOOL PFXExportCertStore(
  [in]      HCERTSTORE      hStore,
  [in, out] CRYPT_DATA_BLOB *pPFX,
  [in]      LPCWSTR         szPassword,
  [in]      DWORD           dwFlags
);

Parâmetros

[in] hStore

Identificador do repositório de certificados que contém os certificados a serem exportados.

[in, out] pPFX

Um ponteiro para uma estrutura CRYPT_DATA_BLOB para conter o pacote PFX com os certificados e chaves exportados. Se pPFX-pbData> for NULL, a função calculará o número de bytes necessários para o BLOB codificado e retornará isso em pPFX-cbData.> Quando a função é chamada com pPFX-pbData> apontando para um buffer alocado do tamanho necessário, a função copia os bytes codificados no buffer e atualizapPFX-cbData> com o comprimento do byte de codificação.

[in] szPassword

Senha de cadeia de caracteres usada para criptografar e verificar o pacote PFX. Quando terminar de usar a senha, limpe a senha da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger senhas, consulte Manipulando senhas.

[in] dwFlags

Os valores de sinalizador podem ser definidos como qualquer combinação do seguinte.

Valor	Significado
EXPORT_PRIVATE_KEYS	As chaves privadas são exportadas, bem como os certificados.
REPORT_NO_PRIVATE_KEY	Se um certificado não tiver nenhuma chave privada associada, a função retornará FALSE com o último erro definido como CRYPT_E_NOT_FOUND ou NTE_NO_KEY.
REPORT_NOT_ABLE_TO_EXPORT_PRIVATE_KEY	Se for encontrado um certificado que tenha uma chave privada não exportável, a função retornará FALSE e o último erro definido como NTE_BAD_KEY, NTE_BAD_KEY_STATE ou NTE_PERM.

Retornar valor

Retornará TRUE (diferente de zero) se a função for bem-sucedida e FALSE (zero) se a função falhar. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll

Confira também

PFXExportCertStoreEx

PFXImportCertStore

Compartilhar via