Método ICertSrvSetup::CAImportPFX (casetup.h)

  • Artigo

O método CAImportPFX importa um certificado de autoridade de certificação (CA) e sua chave privada associada para o repositório de computadores local. Esse método não altera o estado do objeto CCertSrvSetup .

Sintaxe

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

Parâmetros

[in] bstrFileName

Uma cadeia de caracteres que contém o nome de um arquivo PFX usado para importar uma chave privada.

[in] bstrPasswd

Uma cadeia de caracteres que contém uma senha para o arquivo PFX.

[in] bOverwriteExistingKey

Um valor que indica se uma chave existente deve ser substituída com o mesmo nome.

[out] ppVal

O endereço de um ponteiro para uma interface ICertSrvSetupKeyInformation que pode ser usada para definir propriedades da chave privada importada.

Retornar valor

Nenhum

Comentários

O método CAImportPFX usa os parâmetros de entrada para descriptografar e decodificar um arquivo PFX e, em seguida, instala a chave e o certificado no repositório de computadores local. Se o certificado atender aos critérios a seguir e após a instalação da chave, o método retornará um objeto ICertSrvSetupKeyInformation para o chamador.

  • Contém uma chave AT_SIGNATURE que corresponde à chave no contêiner de chave privada.
  • É autoassinado ou tem restrições básicas para uma AC.
  • Passa a validação de cadeia, mas pode ter um erro de revogação offline.
Se o arquivo PFX contiver vários certificados e chaves, CAImportPFX instalará todos os certificados e chaves; no entanto, o objeto ICertSrvSetupKeyInformation retornado contém apenas propriedades do último certificado de AC no arquivo. Quando o chamador terminar de usar o objeto ICertSrvSetupKeyInformation , o chamador deverá liberá-lo usando o método Release .

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho casetup.h
DLL Certocm.dll

Confira também

ICertSrvSetup