Estrutura CRYPTCATSTORE (mscat.h)

[A estrutura CRYPTCATSTORE está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A estrutura CRYPTCATSTORE representa um arquivo de catálogo. A função CryptCATStoreFromHandle preenche essa estrutura usando o identificador retornado por CryptCATOpen.

Sintaxe

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

Membros

cbStruct

O tamanho, em bytes, dessa estrutura.

dwPublicVersion

Um valor que especifica a "PublicVersion" do arquivo de catálogo.

pwszP7File

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo de catálogo. Esse membro deve ser inicializado antes de uma chamada para a função CryptCATPersistStore .

hProv

Um identificador para o provedor de serviços criptográficos (CSP).

dwEncodingType

Um valor que especifica o tipo de codificação usado para o arquivo. Atualmente, apenas X509_ASN_ENCODING e PKCS_7_ASN_ENCODING estão sendo usados; no entanto, tipos de codificação adicionais podem ser adicionados no futuro. Para qualquer tipo de codificação atual, use: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

fdwStoreFlags

Uma combinação bit a bit dos valores a seguir.

Valor	Significado
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES 0x00010000	Exclua hashes de página em SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_FLAGS_MASK 0xffff0000	Para todos os sinalizadores com um valor na palavra superior, defina ou desmarque o sinalizador.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES 0x00020000	Inclua hashes de página em SPC_INDIRECT_DATA. O sinalizador CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES terá precedência se também estiver definido.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG 0x20000000	Abra o arquivo para decodificação sem conteúdo desanexado.
CRYPTCAT_OPEN_SORTED 0x40000000	Abra o catálogo com as entradas classificadas em ordem alfabética por assunto.
CRYPTCAT_OPEN_VERIFYSIGHASH 0x10000000	Verifique o hash de assinatura, mas não a cadeia de certificados.

hReserved

Esse membro é reservado e deve ser NULL.

hAttrs

Esse membro é reservado e deve ser NULL.

hCryptMsg

Um identificador para os bytes decodificados. Esse membro só será definido se o arquivo tiver sido aberto com o sinalizador CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG definido.

hSorted

Esse membro é reservado e deve ser NULL.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	mscat.h