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

Статья
02/29/2024

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

Структура CRYPTCATCDF . CryptCATCDFOpen вызывается MakeCat.

Синтаксис

CRYPTCATCDF * CryptCATCDFOpen(
  [in]           LPWSTR                       pwszFilePath,
  [in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Параметры

[in] pwszFilePath

Указатель на строку, завершающуюся нулевым значением, которая содержит путь к открываемой CDF-файлу.

[in, optional] pfnParseError

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

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

После успешного выполнения эта функция возвращает указатель на только что созданную структуру CRYPTCATCDF . Функция CryptCATCDFOpen возвращает указатель NULL в случае сбоя.

Условие CatalogHeader	Значение по умолчанию
Значение Name не указано.	Имя файла в pwszFilePath используется для выходного файла каталога (CAT).
Значение PublicVersion не указано.	0x00000001
Значение EncodingType не указано.	PKCS_7_ASN_ENCODING или X509_ASN_ENCODING (0x00010001)

Следующие действия выполняются функцией CryptCATCDFOpen для заданных условий ошибки.

Условие ошибки	Выполненное действие
Теги CatalogHeader или Name в CDF не найдены.	Если он указан вызывающим объектом, функция CryptCATCDFOpen вызывает функцию, указанную параметром pfnParseError , и возвращает указатель NULL .
Функция CryptCATCDFOpen вызывает функцию CryptCATOpen , чтобы получить дескриптор выходного файла каталога (CAT), но получает недопустимый дескриптор или дескриптор NULL .	Вызывает функцию CryptCATCDFClose и возвращает указатель NULL .

Дополнительные идентификаторы OID для ветви каталога	Определение
szOID_CATALOG_LIST_MEMBER_V2	1.3.6.1.4.1.311.12.1.3
CAT_MEMBERINFO2_OBJID	1.3.6.1.4.1.311.12.2.3

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Дополнительные идентификаторы OID каталога недоступны.

Требования

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

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