Compartilhar via


Função de retorno de chamada CertStoreProvFindCert

A função de retorno de chamada CertStoreProvFindCert enumera ou localiza o primeiro ou o próximo certificado em um repositório externo que corresponde aos critérios especificados.

Sintaxe

BOOL WINAPI CertStoreProvFindCert(
  _In_    HCERTSTOREPROV              hStoreProv,
  _In_    PCCERT_STORE_PROV_FIND_INFO pFindInfo,
  _In_    PCCERT_CONTEXT              pPrevCertContext,
  _In_    DWORD                       dwFlags,
  _Inout_ void                        **ppvStoreProvFindInfo,
  _Out_   PCCERT_CONTEXT              *ppProvCertContext
);

Parâmetros

hStoreProv [in]

Identificador HCERTSTOREPROV para um repositório de certificados.

pFindInfo [in]

Um ponteiro para uma estrutura CERT_STORE_PROV_FIND_INFO que contém todos os parâmetros passados para a função CertFindCertificateInStore .

pPrevCertContext [in]

Um ponteiro para um CERT_CONTEXT do certificado encontrado. Na primeira chamada para a função, esse parâmetro deve ser definido como NULL. Em chamadas subsequentes, ele deve ser definido como o ponteiro retornado no parâmetro ppProvCertContext na última chamada. Um ponteiro não NULL passado nesse parâmetro é liberado pela função de retorno de chamada.

dwFlags [in]

Todos os valores de sinalizador necessários.

ppvStoreProvFindInfo [in, out]

Um ponteiro para um ponteiro para um buffer para retornar as informações do provedor de repositório. Opcionalmente, o retorno de chamada pode retornar um ponteiro para informações de localização internas nesse parâmetro. Após a primeira chamada, esse parâmetro é definido como o ponteiro retornado pela chamada anterior para a função.

ppProvCertContext [out]

Em uma localização bem-sucedida, um ponteiro para o certificado encontrado é retornado nesse parâmetro.

Valor retornado

Retornará TRUE se a função for bem-sucedida ou FALSE se falhar.

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]

Confira também

CERT_CONTEXT

CERT_STORE_PROV_FIND_INFO

CertFindCertificateInStore