Função de retorno de chamada CertStoreProvFindCTL
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