CertEnumPhysicalStoreCallback callback function

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

Syntax

BOOL WINAPI CertEnumPhysicalStoreCallback(
  _In_ const void                      *pvSystemStore,
  _In_       DWORD                     dwFlags,
  _In_       LPCWSTR                   pwszStoreName,
  _In_       PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  _In_       void                      *pvReserved,
  _In_       void                      *pvArg
);

typedef void (WINAPI *PFN_CERT_ENUM_PHYSICAL_STORE)();

Parameters

pvSystemStore [in]

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.

dwFlags [in]

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.

pwszStoreName [in]

Name of the physical store.

pStoreInfo [in]

A pointer to a CERT_PHYSICAL_STORE_INFO structure containing information about the store.

pvReserved [in]

Reserved for future use.

pvArg [in]

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.

Examples

See Example C Program: Listing System and Physical Stores.

Requirements

See also

Certificate Store Functions

CERT_SYSTEM_STORE_RELOCATE_PARA

CertEnumSystemStore

CertEnumSystemStoreLocation

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore