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

  • Статья

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

Функция CryptCATAdminAddCatalog добавляет каталог в базу данных каталога. База данных каталога — это индекс, который связывает хэши файлов с каталогами, содержащими их. Он используется для ускорения идентификации каталогов при проверке подписи файла. Эта функция является единственным поддерживаемым способом программного добавления каталогов в базу данных каталога Windows. Функция не имеет связанной библиотеки импорта. Для динамической связи с Wintrust.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Синтаксис

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

Параметры

[in] hCatAdmin

Дескриптор, ранее назначенный функцией CryptCATAdminAcquireContext .

[in] pwszCatalogFile

Указатель на строку, завершаемую null, для полного пути к добавляемого каталога.

[in] pwszSelectBaseName

Указатель на строку, завершаемую null, для имени каталога при его хранении. Если параметр имеет значение NULL, для каталога будет создано уникальное имя.

[in] dwFlags

Если указан флаг CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001), каталог, указанный в вызове, будет жестко связан с, а не скопирован. Жесткое связывание вместо копирования каталога сокращает объем дискового пространства, необходимого Windows.

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

Если функция выполняется успешно, возвращаемое значение является дескриптором контекста сведений каталога. Если функция завершается сбоем, возвращается значение NULL. Завершив использование возвращенного дескриптора, освободите его, вызвав функцию CryptCATAdminReleaseCatalogContext .

Чтобы получить дополнительные сведения об ошибке, вызовите функцию GetLastError . Полный список кодов ошибок, предоставляемых операционной системой, см. в разделе Системные коды ошибок.

Требования

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

См. также раздел

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext