CertStoreProvFreeFindCTL callback function

The CertStoreProvFreeFindCTL callback function is called when the certificate returned by the CertStoreProvFindCTL callback was not used, and thus released, in a subsequent call to CertStoreProvFindCTL. Before the CLOSE callback is called, all certificates returned by the CertStoreProvFindCTL callback must be released by the provider using CertStoreProvFindCTL or CertStoreProvFreeFindCTL.

Syntax

BOOL CertStoreProvFreeFindCTL(
  _In_ HCERTSTOREPROV hStoreProv,
  _In_ PCCTL_CONTEXT  pCtlContext,
  _In_ void           *pvStoreProvFindInfo,
  _In_ DWORD          dwFlags
);

Parameters

hStoreProv [in]

HCERTSTOREPROV handle to a certificate store.

pCtlContext [in]

A pointer to a CTL_CONTEXT structure.

pvStoreProvFindInfo [in]

A pointer to a buffer containing find information.

dwFlags [in]

Any needed flag values.

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

CertStoreProvFindCTL

CTL_CONTEXT