Função CertEnumCertificateContextProperties (wincrypt.h)

A função CertEnumCertificateContextProperties recupera a primeira ou a próxima propriedade estendida associada a um contexto de certificado. Usada em um loop, essa função pode recuperar em sequência todas as propriedades estendidas associadas a um contexto de certificado.

Sintaxe

DWORD CertEnumCertificateContextProperties(
  [in] PCCERT_CONTEXT pCertContext,
  [in] DWORD          dwPropId
);

Parâmetros

[in] pCertContext

Um ponteiro para a estrutura CERT_CONTEXT do certificado que contém as propriedades a serem enumeradas.

[in] dwPropId

Número da propriedade da última propriedade enumerada. Para obter a primeira propriedade, dwPropId é zero. Para recuperar as propriedades subsequentes, dwPropId é definido como o número da propriedade retornado pela última chamada para a função. Para enumerar todas as propriedades, as chamadas de função continuam até que a função retorne zero.

Os aplicativos podem chamar CertGetCertificateContextProperty com o dwPropId retornado por essa função para recuperar os dados dessa propriedade.

Retornar valor

O valor retornado é um valor DWORD que identifica a propriedade de um contexto de certificado . O valor DWORD retornado por uma chamada da função pode ser fornecido como dwPropId em uma chamada subsequente para a função. Se não houver mais propriedades a serem enumeradas ou se a função falhar, zero será retornado.

Comentários

CERT_KEY_PROV_HANDLE_PROP_ID e CERT_KEY_SPEC_PROP_ID propriedades são armazenadas como membros da propriedade CERT_KEY_CONTEXT_PROP_ID. Eles não são enumerados individualmente.

Exemplos

Consulte Exemplo de programa C: listando os certificados em um repositório.

Requisitos

Confira também

CERT_CONTEXT

CertGetCertificateContextProperty

Funções de propriedade estendidas