Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves the first or next system store location. Used in a loop, this function can retrieve in sequence all system store locations.

Syntax 

BOOL WINAPI CertEnumSystemStoreLocation(
  DWORD 
dwFlags,
  void* 
pvArg,
  PFN_CERT_ENUM_SYSTEM_STORE_LOCATION 
pfnEnum 
);

Parameters

dwFlags

[in] Reserved for future use and must be set to zero.

pvArg

[in] Pointer to a void allowing the application to declare, define, and initialize a structure to hold any information to be passed to the callback enumeration function.

pfnEnum

[in] 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 following example shows the signature of the callback function that is to be provided by the application.

Copy Code 
BOOL  WINAPI CertEnumStoreLocationCallback(
  LPCWSTR 
pvszStoreLoocations	
  DWORD 
dwFlags, 				 
  void 
*pvReserved, 			
  void 
*pvArg					
);

The pvArgparameter passed to the callback function is the pvArgpointer passed to the CertEnumSystemStoreLocationfunction.

Return Value

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

Remarks

To use this function, an application must declare and define the ENUM_ARGstructure and an enumeration callback function.

Requirements

Header wincrypt.h
Library crypt32.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also