CertStoreProvFreeFindCert callback function

  • Article

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

Syntax

BOOL WINAPI CertStoreProvFreeFindCert(
  _In_ HCERTSTOREPROV hStoreProv,
  _In_ PCCERT_CONTEXT pCertContext,
  _In_ void           *pvStoreProvFindInfo,
  _In_ DWORD          dwFlags
);

Parameters

hStoreProv [in]

HCERTSTOREPROV handle to a certificate store.

pCertContext [in]

A pointer to a CERT_CONTEXT.

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

CERT_CONTEXT

CertStoreProvFindCert