PFN_CERT_ENUM_PHYSICAL_STORE callback function (wincrypt.h)

The CertEnumPhysicalStoreCallback callback function formats and presents information on each physical store found by a call to CertEnumPhysicalStore.

Syntax

PFN_CERT_ENUM_PHYSICAL_STORE PfnCertEnumPhysicalStore;

BOOL PfnCertEnumPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] LPCWSTR pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

Parameters

[in] pvSystemStore

If CERT_SYSTEM_STORE_RELOCATE_FLAG is set in dwFlags, pvSystemStore points to a CERT_SYSTEM_STORE_RELOCATE_PARA structure that indicates both the name and the location of the system store to be enumerated. Otherwise, pvSystemStore is a pointer to a Unicode string that names the system store whose physical stores are to be enumerated. For information about prefixing the name of a service or computer to the system store name, see CertRegisterSystemStore.

[in] dwFlags

Specifies the location of the system store. The following flag values are defined:

  • CERT_SYSTEM_STORE_CURRENT_USER
  • CERT_SYSTEM_STORE_CURRENT_SERVICE
  • CERT_SYSTEM_STORE_LOCAL_MACHINE
  • CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
  • CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY
  • CERT_SYSTEM_STORE_SERVICES
  • CERT_SYSTEM_STORE_USERS
  • CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE
In addition, CERT_SYSTEM_STORE_RELOCATE_FLAG or CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG can be combined using a bitwise-OR operation with any of the high-word location flags. The CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG constant is set if the physical store is predefined rather than registered.

[in] pwszStoreName

Name of the physical store.

[in] pStoreInfo

A pointer to a CERT_PHYSICAL_STORE_INFO structure containing 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 CertEnumPhysicalStore.

Return value

Returns TRUE if the function succeeds, 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

CERT_SYSTEM_STORE_RELOCATE_PARA

CertEnumSystemStore

CertEnumSystemStoreLocation

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore

Certificate Store Functions