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

Структура CRYPTCATSTORE (mscat.h)

  • Статья

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

Структура CRYPTCATSTORE представляет файл каталога. Функция CryptCATStoreFromHandle заполняет эту структуру с помощью дескриптора, возвращенного CryptCATOpen.

Синтаксис

typedef struct CRYPTCATSTORE_ {
  DWORD      cbStruct;
  DWORD      dwPublicVersion;
  LPWSTR     pwszP7File;
  HCRYPTPROV hProv;
  DWORD      dwEncodingType;
  DWORD      fdwStoreFlags;
  HANDLE     hReserved;
  HANDLE     hAttrs;
  HCRYPTMSG  hCryptMsg;
  HANDLE     hSorted;
} CRYPTCATSTORE;

Члены

cbStruct

Размер данной структуры (в байтах).

dwPublicVersion

Значение типа , указывающее "PublicVersion" файла каталога.

pwszP7File

Указатель на строку, завершающуюся null, которая содержит имя файла каталога. Этот элемент необходимо инициализировать перед вызовом функции CryptCATPersistStore .

hProv

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

dwEncodingType

Значение типа , указывающее тип кодирования, используемый для файла. В настоящее время используются только X509_ASN_ENCODING и PKCS_7_ASN_ENCODING; однако в будущем могут быть добавлены дополнительные типы кодирования. Для любого текущего типа кодирования используйте: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

fdwStoreFlags

Побитовая комбинация следующих значений.

Значение Значение
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES
0x00010000
 Исключите хэши страниц в SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_FLAGS_MASK
0xffff0000
 Для всех флагов со значением в верхнем слове установите или снимите флажок.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES
0x00020000
 Включите хэши страниц в SPC_INDIRECT_DATA. Флаг CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES имеет приоритет, если он также задан.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG
0x20000000
 Откройте файл для декодирования без отсоединяемого содержимого.
CRYPTCAT_OPEN_SORTED
0x40000000
 Откройте каталог с записями, отсортированные в алфавитном порядке по теме.
CRYPTCAT_OPEN_VERIFYSIGHASH
0x10000000
 Проверьте хэш подписи, но не цепочку сертификатов.

hReserved

Этот элемент зарезервирован и должен иметь значение NULL.

hAttrs

Этот элемент зарезервирован и должен иметь значение NULL.

hCryptMsg

Дескриптор декодированных байтов. Этот элемент задается, только если файл был открыт с установленным флагом CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG .

hSorted

Этот элемент зарезервирован и должен иметь значение NULL.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть mscat.h