Compartilhar via


Função CertCreateCertificateChainEngine (wincrypt.h)

A função CertCreateCertificateChainEngine cria um novo mecanismo de cadeia não padrão para um aplicativo. Um mecanismo de cadeia restringe os certificados no repositório raiz que podem ser usados para verificação, restringe os repositórios de certificados a serem pesquisados em busca de certificados e CTLs ( listas de confiança de certificado ), define um limite de tempo limite para pesquisas que envolvem URLs e limita o número de certificados verificados entre a verificação de um ciclo de certificado.

Sintaxe

BOOL CertCreateCertificateChainEngine(
  [in]  PCERT_CHAIN_ENGINE_CONFIG pConfig,
  [out] HCERTCHAINENGINE          *phChainEngine
);

Parâmetros

[in] pConfig

Um ponteiro para uma estrutura de dados CERT_CHAIN_ENGINE_CONFIG que especifica os parâmetros para o mecanismo de cadeia.

[out] phChainEngine

Um ponteiro para o identificador do mecanismo de cadeia criado. Quando terminar de usar o mecanismo de cadeia, libere o mecanismo de cadeia chamando a função CertFreeCertificateChainEngine .

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero (TRUE).

Se a função falhar, ela retornará zero (FALSE). Para obter informações de erro estendidas, chame GetLastError.

O parâmetro phChainEngine retorna o identificador do mecanismo de cadeia.

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

CERT_CHAIN_ENGINE_CONFIG

CertFreeCertificateChainEngine

Funções de verificação da cadeia de certificados

Obter Último Erro