PFN_CERT_STORE_PROV_READ_CERT callback function (wincrypt.h)

An application-defined callback function that reads the provider's copy of the certificate context. If one exists, a new certificate context is created. Currently not called directly by the certificate store functions. However, it might be exported to support other providers.

Syntax

PFN_CERT_STORE_PROV_READ_CERT PfnCertStoreProvReadCert;

BOOL PfnCertStoreProvReadCert(
  [in]  HCERTSTOREPROV hStoreProv,
  [in]  PCCERT_CONTEXT pStoreCertContext,
  [in]  DWORD dwFlags,
  [out] PCCERT_CONTEXT *ppProvCertContext
)
{...}

Parameters

[in] hStoreProv

Provider-specific value returned in CERT_STORE_PROV_INFO by CertDllOpenStoreProv.

[in] pStoreCertContext

A pointer to the CERT_CONTEXT of the certificate to be read.

[in] dwFlags

Reserved for future use and is set to zero.

[out] ppProvCertContext

A pointer to a pointer to provider's copy of the certificate context. The context will be freed by calling CertFreeCertificateContext.

Return value

Returns TRUE if the certificate was successfully read.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header wincrypt.h

See also

CERT_CONTEXT

CERT_STORE_PROV_INFO

Callback Functions

CertDllOpenStoreProv

CertFreeCertificateContext