Функция CertEnumPhysicalStore (wincrypt.h)

Статья
08/27/2023

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

Синтаксис

BOOL CertEnumPhysicalStore(
  [in] const void                   *pvSystemStore,
  [in] DWORD                        dwFlags,
  [in] void                         *pvArg,
  [in] PFN_CERT_ENUM_PHYSICAL_STORE pfnEnum
);

Параметры

[in] pvSystemStore

Если CERT_SYSTEM_STORE_RELOCATE_FLAG задано в dwFlags, pvSystemStore указывает на CERT_SYSTEM_STORE_RELOCATE_PARA структуру, которая указывает как имя, так и расположение перечисляемого системного хранилища. В противном случае pvSystemStore — это указатель на строку Юникода, которая называет системное хранилище, физические хранилища которого необходимо перечислить. Сведения о префиксе ServiceName или ComputerName к имени системного хранилища см. в разделе 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 можно объединить с помощью побитовой операции ИЛИ с любым из флагов расположения в высоком слове.

[in] pvArg

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

[in] pfnEnum

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

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

Если функция выполнена успешно и было найдено другое физическое хранилище, возвращается значение TRUE.

Если расположение системного хранилища поддерживает только системные хранилища и не поддерживает физические хранилища, функция возвращает значение FALSE , а GetLastError — код ERROR_NOT_SUPPORTED.

Если функция завершается сбоем и другое физическое хранилище не найдено, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	wincrypt.h
Библиотека	Crypt32.lib
DLL	Crypt32.dll