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

Статья
08/27/2023

Функция CertRegisterPhysicalStore добавляет физическое хранилище в коллекцию системных хранилищ реестра.

Синтаксис

BOOL CertRegisterPhysicalStore(
  [in] const void                *pvSystemStore,
  [in] DWORD                     dwFlags,
  [in] LPCWSTR                   pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void                      *pvReserved
);

Параметры

[in] pvSystemStore

Коллекция системного хранилища, в которую добавляется физическое хранилище. Этот параметр указывает либо на строку Юникода, завершаемую null, либо на CERT_SYSTEM_STORE_RELOCATE_PARA структуру. Сведения об использовании структуры и добавлении ServiceName или ComputerName перед строкой имени системного хранилища см. в разделе CertRegisterSystemStore.

[in] dwFlags

Высокое слово параметра dwFlags указывает расположение системного хранилища. Сведения о определенных флагах высокого уровня слов и добавлении ServiceName, UserNames и ComputerNames в конец имени системного хранилища см. в разделе CertRegisterSystemStore.

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

Значение	Значение
CERT_SYSTEM_STORE_RELOCATE_FLAG	Системное хранилище не находится в расположении реестра по умолчанию, а параметр pvSystemStore должен быть указателем на структуру CERT_SYSTEM_STORE_RELOCATE_PARA .
CERT_STORE_CREATE_NEW_FLAG	Функция завершается сбоем, если физическое хранилище уже существует в расположении хранилища.

[in] pwszStoreName

Указатель на строку Юникода, которая называет физическое хранилище, добавляемое в коллекцию системного хранилища. Чтобы удалить физическое хранилище из коллекции системных хранилищ, вызовите функцию CertUnregisterPhysicalStore .

[in] pStoreInfo

Указатель на структуру CERT_PHYSICAL_STORE_INFO , которая предоставляет основные сведения о физическом хранилище.

[in] pvReserved

Зарезервировано для использования в будущем и должно иметь значение NULL.

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

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

Если функция завершается сбоем, она возвращает ноль.

Требования


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