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