CertEnumSystemStoreLocation

[This is preliminary documentation and subject to change.]

The CertEnumSystemStoreLocation function enumerates all of the locations that have an available system store.

#include <wincrypt.h>
BOOL WINAPI CertEnumSystemStoreLocation(
  DWORD dwFlags,                               //in
  void *pvArg,                                 //in
  PFN_CERT_ENUM_SYSTEM_STORE_LOCATION pfnEnum  //in
);

Parameters

dwFlags

The HIWORD of the dwFlags is not used and must be set to 0.

pvArg

Pointer to a void which allows the application to declare, define, and initialize a data structure to hold any information to be passed to the callback enumeration function.

pfnEnum

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. The callback function must be provided by the application and must be declared with the following signature:

BOOL  WINAPI CertEnumStoreLocationCallback(
  const void *pvSystemStore,           // in
  DWORD dwFlags,                       // in
  PCERT_SYSTEM_STORE_INFO pStoreInfo,  // in
  void *pvReserved,                    // in, optional
  void *pvArg                          // in, optional
);

The pvArg passed to the callback function is the pvArg pointer passed to CertEnumSystemStoreLocation.

Return Values

TRUE if the function succeeded. FALSE if the function failed.

Call GetLastError to see the reason for any failures.

Remarks

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

Example

See Example Code for Listing System and Physical Stores.

QuickInfo