CertStoreProvFindCTL callback function
The CertStoreProvFindCTL callback function enumerates or finds the first or next CTL in an external store that matches specified criteria.
Syntax
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
);
Parameters
-
hStoreProv [in]
-
HCERTSTOREPROV handle to a certificate store.
-
pFindInfo [in]
-
A pointer to a CERT_STORE_PROV_FIND_INFO structure containing all the parameters passed to the CertFindCTLInStore. function.
-
pPrevCtlContext [in]
-
A pointer to a CTL_CONTEXT structure of the last CTL found. On first call to the function, this parameter should be set to NULL. On subsequent calls, it should be set to the pointer returned in the ppProvCTLContext parameter on the last call. A non-NULL pointer passed in this parameter is freed by the callback function.
-
dwFlags [in]
-
Any needed flag values.
-
ppvStoreProvFindInfo [in, out]
-
A pointer to a pointer to buffer to return the store provider information. Optionally, the callback can return a pointer to internal find information in this parameter. After the first call, this parameter is set to the pointer returned by the previous call to the function.
-
ppProvCtlContext [out]
-
On a successful find, a pointer to the CTL found is returned in this parameter.
Return value
Returns TRUE if the function succeeds or FALSE if it fails.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows XP [desktop apps only] |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
See also