Поделиться через


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

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

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

Синтаксис

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

Параметры

[in] pwszFilePath

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

[in, optional] pfnParseError

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

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

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

Замечания

Следующие значения по умолчанию используются функцией CryptCATCDFOpen для заданных условий в разделе CDF CatalogHeader .

Условие CatalogHeader Значение по умолчанию
Значение имени не указано. Имя файла в 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 для ветви каталога Definition
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: Дополнительные идентификаторы каталога недоступны.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
Header mscat.h
Library nanosrv.lib
DLL Wintrust.dll

См. также

CRYPTCATCDF

CryptCATCDFClose

CryptCATOpen

MakeCat