CertEnumSystemStoreLocation function (wincrypt.h)

Article
10/13/2021

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

Requirement	Value
Minimum supported client	Windows XP [desktop apps \| UWP apps]
Minimum supported server	Windows Server 2003 [desktop apps \| UWP apps]
Target Platform	Windows
Header	wincrypt.h
Library	Crypt32.lib
DLL	Crypt32.dll

Share via