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

See Also

Reference

Certificates Callback Functions