CertEnumSystemStoreLocation

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

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 Values

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

OS Versions: Windows CE 3.0 and later.
Header: Wincrypt.h.
Link Library: Crypt32.lib.

See Also

CertEnumSystemStore

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.