PFN_CERT_ENUM_PHYSICAL_STORE (Compact 2013)

3/28/2014

This callback function formats and presents information on each physical store that is found by a call to CertEnumPhysicalStore.

Syntax

typedef BOOL (WINAPI *PFN_CERT_ENUM_PHYSICAL_STORE)(
    __in const void *pvSystemStore,
    __in DWORD dwFlags,
    __in LPCWSTR pwszStoreName,
    __in PCERT_PHYSICAL_STORE_INFO pStoreInfo,
    __reserved void *pvReserved,
    __inout_opt void *pvArg
    );

Parameters

  • pvSystemStore
    [in] Pointer to the system store to be enumerated. If CERT_SYSTEM_STORE_RELOCATE_FLAG is set in dwFlags, a pointer to a CERT_SYSTEM_STORE_RELOCATE_PARA structure that indicates both the name and the location of the system store to be enumerated. Otherwise, a pointer to a Unicode string that names the system store whose physical stores are to be enumerated.
  • dwFlags
    [in] The location of the system store. The following flag values are defined:

    • CERT_SYSTEM_STORE_CURRENT_USER
    • CERT_SYSTEM_STORE_CURRENT_SERVICE
    • CERT_SYSTEM_STORE_LOCAL_MACHINE
    • 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

    In addition, CERT_SYSTEM_STORE_RELOCATE_FLAG or CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG can be combined using a bitwise-OR operation with any of the high-word location flags. The CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG constant is set if the physical store is predefined rather than registered.

  • pwszStoreName
    [in] Name of the physical store.
  • pStoreInfo
    [in] Pointer to a CERT_PHYSICAL_STORE_INFO structure that contains information about the store.
  • pvReserved
    Reserved for future use.
  • pvArg
    [in, out] Pointer to optional information that is passed to the callback function through the CertEnumPhysicalStorepvArg parameter.

Return Value

Returns TRUE if the function succeeds; otherwise, returns FALSE.

Requirements

Header

wincrypt.h

See Also

Reference

Certificates Callback Functions