Compartilhar via


Função CertFindSubjectInSortedCTL (wincrypt.h)

A função CertFindSubjectInSortedCTL tenta localizar a entidade especificada em uma CTL (lista de certificados confiáveis ) classificada. Uma entidade pode ser identificada por todo o contexto do certificado ou por qualquer identificador exclusivo da entidade do certificado, como o hash SHA1 do emissor do certificado e o número de série.

Sintaxe

BOOL CertFindSubjectInSortedCTL(
  [in]  PCRYPT_DATA_BLOB pSubjectIdentifier,
  [in]  PCCTL_CONTEXT    pCtlContext,
  [in]  DWORD            dwFlags,
  [in]  void             *pvReserved,
  [out] PCRYPT_DER_BLOB  pEncodedAttributes
);

Parâmetros

[in] pSubjectIdentifier

Um ponteiro para uma estrutura CRYPT_DATA_BLOB identificando exclusivamente o assunto. As informações nessa estrutura podem ser um hash ou qualquer sequência de bytes exclusiva.

[in] pCtlContext

Um ponteiro para a estrutura CTL_CONTEXT a ser pesquisada.

[in] dwFlags

Reservado para uso futuro e deve ser NULL.

[in] pvReserved

Reservado para uso futuro e deve ser NULL.

[out] pEncodedAttributes

Um ponteiro para uma estrutura CRYPT_DER_BLOB que contém uma contagem de bytes e um ponteiro para os atributos codificados da entidade.

Retornar valor

Se a função for bem-sucedida e o identificador do assunto existir na CTL, o valor retornado será TRUE.

Se a função falhar e não localizar um identificador de assunto correspondente, o valor retornado será FALSE.

Requisitos

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

Confira também

CTL_CONTEXT

CertEnumSubjectInSortedCTL

Funções de manutenção do repositório de certificados e certificados