функция обратного вызова PFN_CERT_ENUM_PHYSICAL_STORE (wincrypt.h)

Статья
08/27/2023

Функция обратного вызова CertEnumPhysicalStoreCallback форматирует и предоставляет сведения о каждом физическом хранилище, найденном при вызове CertEnumPhysicalStore.

Синтаксис

PFN_CERT_ENUM_PHYSICAL_STORE PfnCertEnumPhysicalStore;

BOOL PfnCertEnumPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] LPCWSTR pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

Параметры

[in] pvSystemStore

Если CERT_SYSTEM_STORE_RELOCATE_FLAG задано в dwFlags, pvSystemStore указывает на CERT_SYSTEM_STORE_RELOCATE_PARA структуру, которая указывает как имя, так и расположение системного хранилища для перечисления. В противном случае pvSystemStore — это указатель на строку Юникода, которая называет системное хранилище, физические хранилища которого необходимо перечислить. Сведения о префиксе имени службы или компьютера к имени системного хранилища см. в разделе CertRegisterSystemStore.

[in] dwFlags

Указывает расположение системного хранилища. Определены следующие значения флагов:

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

Кроме того, CERT_SYSTEM_STORE_RELOCATE_FLAG или CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG можно объединить с помощью побитовой операции ИЛИ с любым из флагов расположения с высоким уровнем слов. Константная CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG устанавливается, если физическое хранилище является предопределенным, а не зарегистрированным.

[in] pwszStoreName

Имя физического хранилища.

[in] pStoreInfo

Указатель на структуру CERT_PHYSICAL_STORE_INFO , содержащую сведения о хранилище.

[in] pvReserved

Зарезервировано для последующего использования.

[in] pvArg

Указатель на сведения, передаваемые функции обратного вызова в pvArg , переданном в CertEnumPhysicalStore.

Возвращаемое значение

Возвращает значение TRUE , если функция завершается успешно, и FALSE , если она завершается сбоем.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wincrypt.h