Поделиться через

Функция CryptCATPersistStore (mscat.h)

  • Статья

[Функция CryptCATPersistStore доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция CryptCATPersistStore сохраняет сведения из указанного хранилища каталога в неподписанный файл каталога.

Синтаксис

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

Параметры

[in] hCatalog

Дескриптор каталога, полученный из функции CryptCATHandleFromStore или CryptCATOpen . Начиная с Windows 8 для получения дескриптора необходимо использовать только CryptCATOpen .

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

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

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

Код возврата Описание
ERROR_INVALID_PARAMETER
 Один или несколько параметров являются недопустимыми.
ERROR_NOT_SUPPORTED
 Начиная с Windows 8 и Windows Server 2012, необходимо получить дескриптор, вызвав функцию CryptCATOpen с параметром dwPublicVersion , для которого задано значение 0x100 или 0x200. Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Структура CRYPTCATSTORE должна быть инициализирована перед вызовом CryptCATPersistStore.

Начиная с Windows 8 и Windows Server 2012, к этой функции применяются следующие изменения:

  • Если CryptCATOpen был вызван с параметром dwPublicVersion 0x200, каталог записывается в формате версии 2.
  • Если CryptCATOpen был вызван с параметром dwPublicVersion 0x100, каталог записывается в формате версии 1.
  • Если CryptCATOpen был вызван с параметром dwPublicVersion , отличным от 0x200 или 0x100, функция CryptCATPersistStore возвращает значение FALSE , а для кода ошибки задано значение ERROR_NOT_SUPPORTED.

Требования

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