CertEnumSystemStoreLocation function (wincrypt.h)

The CertEnumSystemStoreLocation function retrieves all of the system store locations. The function calls the provided callback function for each system store location found.

Syntax

BOOL CertEnumSystemStoreLocation(
  [in] DWORD                               dwFlags,
  [in] void                                *pvArg,
  [in] PFN_CERT_ENUM_SYSTEM_STORE_LOCATION pfnEnum
);

Parameters

[in] dwFlags

Reserved for future use; must be zero.

[in] pvArg

A pointer to a void that allows the application to declare, define, and initialize a structure to hold any information to be passed to the callback enumeration function.

[in] pfnEnum

A pointer to the callback function used to show the details for each store location. This callback function determines the content and format for the presentation of information on each store location. For the signature and parameters of the callback function, see CertEnumSystemStoreLocationCallback.

Return value

If the function succeeds, the function returns TRUE.

If the function fails, it returns FALSE.

Remarks

To use CertEnumSystemStoreLocation, an application must declare and define the ENUM_ARG structure and an enumeration callback function.

Examples

For an example that uses this function, see Example C Program: Listing System and Physical Stores.

Requirements

See also

CertEnumPhysicalStore

CertEnumSystemStore

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore

Certificate Store Functions