Método ICertAdmin2::ImportKey (certadm.h)

Artigo
03/05/2024

O método ImportKey adiciona um conjunto de chaves criptografada a um item no banco de dados dos Serviços de Certificados. O conjunto de chaves é criptografado para um ou vários certificados kra (agente de recuperação de chave).

Sintaxe

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

Parâmetros

[in] strConfig

Valor de cadeia de caracteres que representa uma cadeia de caracteres de configuração válida para a AC (autoridade de certificação ) no formulário COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor dos Serviços de Certificados e CANAME é o nome comum da AC, conforme inserido durante a instalação dos Serviços de Certificado. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.

ImportanteImportKey não limpa o cache interno quando a cadeia de caracteres de configuração é alterada. Ao alterar a cadeia de caracteres de configuração para a AC, você deve instanciar um novo objeto ICertAdmin e chamar esse método novamente com a nova cadeia de caracteres de configuração.

[in] RequestId

Valor LONG que representa a ID da solicitação de certificado no banco de dados do Certificates Services. Se o número de série (passado como strCertHash) for usado em vez da ID da solicitação, use zero para esse valor.

[in] strCertHash

Valor de cadeia de caracteres que representa o hash do certificado. Para que strCertHash seja usado, você deve especificar um valor igual a zero para RequestId.

[in] Flags

Especifica o formato da chave. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
CR_IN_BASE64HEADER	Formato BASE64 com início ou término.
CR_IN_BASE64	Formato BASE64 sem início ou término.
CR_IN_BINARY	Formato binário.

Além disso, o valor a seguir pode ser combinado com o valor de formato usando uma operação OR bit a bit.

Valor	Significado
IKF_OVERWRITE	Todas as informações codificadas em KRA existentes são substituídas.

[in] strKey

Valor de cadeia de caracteres que representa as informações da chave KRA.

Retornar valor

Nenhum

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certadm.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll

Confira também

ICertAdmin2

Compartilhar via