CertEnumSystemStore

  • Article

This function retrieves the first or next system store available. Used in a loop, this function can retrieve in sequence all of the system stores available on a computer.

BOOL WINAPI CertEnumSystemStore(
  DWORD dwFlags,
  void* pvSystemStoreLocationPara,
  void* pvArg,
  PFN_CERT_ENUM_SYSTEM_STORE pfnEnum
);

Parameters

  • dwFlags
    [in] Specifies the location of the system store. The following flag values are defined:

    CERT_SYSTEM_STORE_CURRENT_USER

    CERT_SYSTEM_STORE_LOCAL_MACHINE

    In addition, CERT_SYSTEM_STORE_RELOCATE_FLAG can be combined using a bitwise OR operation with any of the high-word location flags.

  • pvSystemStoreLocationPara
    [in] Optional. If CERT_SYSTEM_STORE_RELOCATE_FLAG is set in the dwFlags parameter, pvSystemStoreLocationPara points to a CERT_SYSTEM_STORE_RELOCATE_PARA structure that indicates both the name and the location of the system store. Otherwise, pvSystemStoreLocationPara is a pointer to a Unicode string that names the system store.

  • 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 system store. This callback function determines the content and format for the presentation of information on each system store. The application must provide the callback function and must declare it with the following signature.

    BOOL  WINAPI CertEnumSystemStoreCallback(
  const void *pvSystemStore,
  DWORD dwFlags,                       
  PCERT_SYSTEM_STORE_INFO pStoreInfo,  
  void *pvReserved,                    
  void *pvArg                          
);

    The pvArg parameter passed to the callback function is the pvArg pointer passed to the CertEnumSystemStore 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, the application must declare and define the ENUM_ARG structure and an enumeration callback function.

To access a remote store, the security permissions in the registry keys on that remote computer must be set to allow access.

The desktop platform supports the following dwFlags that Windows CE does not support:

CERT_SYSTEM_STORE_CURRENT_SERVICE

CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY

CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY

CERT_SYSTEM_STORE_SERVICES

CERT_SYSTEM_STORE_USERS

CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE

Requirements

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

See Also

CertEnumSystemStoreLocation | CERT_SYSTEM_STORE_RELOCATE_PARA

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.