Função de retorno de chamada CertStoreProvFindCTL

  • Artigo

A função de retorno de chamada CertStoreProvFindCTL enumera ou localiza a primeira ou a próxima CTL em um repositório externo que corresponde aos critérios especificados.

Sintaxe

BOOL WINAPI CertStoreProvFindCTL(
  _In_    HCERTSTOREPROV              hStoreProv,
  _In_    PCCERT_STORE_PROV_FIND_INFO pFindInfo,
  _In_    PCCTL_CONTEXT               pPrevCtlContext,
  _In_    DWORD                       dwFlags,
  _Inout_ void                        **ppvStoreProvFindInfo,
  _Out_   PCCTL_CONTEXT               *ppProvCtlContext
);

Parâmetros

hStoreProv [in]

Identificador HCERTSTOREPROV para um repositório de certificados.

pFindInfo [in]

Um ponteiro para uma estrutura de CERT_STORE_PROV_FIND_INFO que contém todos os parâmetros passados para o CertFindCTLInStore. .

pPrevCtlContext [in]

Um ponteiro para uma estrutura CTL_CONTEXT da última CTL encontrada. 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 ppProvCTLContext 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 buffer para retornar as informações do provedor do repositório. Opcionalmente, o retorno de chamada pode retornar um ponteiro para localizar informações internas nesse parâmetro. Após a primeira chamada, esse parâmetro é definido como o ponteiro retornado pela chamada anterior para a função.

ppProvCtlContext [out]

Em uma localização bem-sucedida, um ponteiro para a CTL encontrada é 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_STORE_PROV_FIND_INFO

CertFindCTLInStore

CTL_CONTEXT