Функция 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 |