CertEnumSystemStoreLocation

A version of this page is also available for

Windows Embedded CE 6.0 R3

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.

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

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

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_ARG structure 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

Reference

CertEnumSystemStore