PFN_CERT_STORE_PROV_READ_CTL callback function (wincrypt.h)

The CertStoreProvReadCTL callback function is called to read the provider's copy of the CTL context and, if it exists, to create a new CTL context. Currently, this callback function is not called directly by the store APIs but it can be exported to support other providers based on it.

Syntax

PFN_CERT_STORE_PROV_READ_CTL PfnCertStoreProvReadCtl;

BOOL PfnCertStoreProvReadCtl(
  [in]  HCERTSTOREPROV hStoreProv,
  [in]  PCCTL_CONTEXT pStoreCtlContext,
  [in]  DWORD dwFlags,
  [out] PCCTL_CONTEXT *ppProvCtlContext
)
{...}

Parameters

[in] hStoreProv

HCERTSTOREPROV handle to a certificate store.

[in] pStoreCtlContext

A pointer to a CTL_CONTEXT structure.

[in] dwFlags

Any needed flag values.

[out] ppProvCtlContext

A pointer to a pointer to a CTL_CONTEXT structure to be returned by the function. The context will be freed by calling CertFreeCTLContext.

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]
Target Platform Windows
Header wincrypt.h

See also

CTL_CONTEXT