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

Статья
08/24/2023

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

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

Примечание Некоторые более старые версии Wintrust.lib не содержат сведения об экспорте для этой функции. В этом случае необходимо использовать функции LoadLibrary и GetProcAddress , чтобы динамически связываться с Wintrust.dll.

Синтаксис

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Параметры

[in] pwszFileName

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

[in] fdwOpenFlags

Нуль, чтобы открыть существующий файл каталога, или побитовое сочетание одного или нескольких следующих значений.

Значение	Значение
CRYPTCAT_OPEN_ALWAYS	Открывает файл , если он существует, или при необходимости создает новый файл.
CRYPTCAT_OPEN_CREATENEW	Будет создан новый файл каталога. Если ранее созданный файл существует, он перезаписывается.
CRYPTCAT_OPEN_EXISTING	Откроется существующий файл каталога.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES	Откроется существующий файл каталога. Исключите хэши страниц в SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES	Откроется существующий файл каталога. Включите хэши страниц в SPC_INDIRECT_DATA. Приведенный выше CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES имеет приоритет, если он также задан.
CRYPTCAT_OPEN_VERIFYSIGHASH	Откроется существующий файл каталога. Проверяет подпись, а не сертификаты.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG	Откроется существующий файл каталога. Выполняет CryptMsgDecode без содержимого.
CRYPTCAT_OPEN_SORTED	Откроется существующий файл каталога. Выполняется ли CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG).

[in] hProv

Дескриптор поставщика служб шифрования (CSP).

[in] dwPublicVersion

Версия файла. Это может быть одно из следующих значений.

Значение	Значение
CRYPTCAT_VERSION_1 0x100	Формат файла версии 1.
CRYPTCAT_VERSION_2 0x200	Формат файла версии 2. Windows 8 и Windows Server 2012: Поддержка этого значения начинается.

[in] dwEncodingType

Тип кодирования, используемый для файла. Если это значение равно 0, то для типа кодирования устанавливается значение PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

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

При успешном выполнении эта функция возвращает дескриптор в открытый каталог. Завершив использование дескриптора, закройте его, вызвав функцию CryptCATClose . Функция CryptCATOpen возвращает INVALID_HANDLE_VALUE в случае сбоя.

Требования


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

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

CryptCATClose