Edit

Share via

PFN_CERT_ENUM_SYSTEM_STORE callback function (wincrypt.h)

  • Article

The CertEnumSystemStoreCallback callback function formats and presents information on each system store found by a call to CertEnumSystemStore.

Syntax

PFN_CERT_ENUM_SYSTEM_STORE PfnCertEnumSystemStore;

BOOL PfnCertEnumSystemStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] PCERT_SYSTEM_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

Parameters

[in] pvSystemStore

A pointer to information on the system store found by a call to CertEnumSystemStore. Where appropriate, this argument will contain a leading computer name or service name prefix.

[in] dwFlags

Flag used to call for an alteration of the presentation. This can be a bitwise OR of the following values.

Value Meaning
CERT_SYSTEM_STORE_LOCATION_MASK
 Specifies the location of the system store.
CERT_SYSTEM_STORE_RELOCATE_FLAG
 If set, the pvSystemStore parameter points to a CERT_SYSTEM_STORE_RELOCATE_PARA structure. If not set, pvSystemStore points to a NULL-terminated Unicode string.

[in] pStoreInfo

A pointer to a CERT_SYSTEM_STORE_INFO structure that contains information about the store.

[in] pvReserved

Reserved for future use.

[in] pvArg

A pointer to information passed to the callback function in the pvArg passed to CertEnumSystemStore.

Return value

If the function succeeds, the function returns TRUE.

To stop the enumeration, the function must return FALSE.

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