Функция CryptCATCDFOpen (mscat.h)
[Функция 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 в случае сбоя.
Комментарии
Следующие значения по умолчанию используются функцией CryptCATCDFOpen для заданных условий в разделе CDF CatalogHeader .
| Условие 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 |