Export (0) Print
Expand All
Expand Minimize

CRYPTCATSTORE structure

[The CRYPTCATSTORE structure is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

The CRYPTCATSTORE structure represents a catalog file. The CryptCATStoreFromHandle function populates this structure by using the handle returned by CryptCATOpen.

Syntax


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

Members

cbStruct

The size, in bytes, of this structure.

dwPublicVersion

A value that specifies the "PublicVersion" of the catalog file.

pwszP7File

A pointer to a null-terminated string that contains the name of the catalog file. This member must be initialized before a call to the CryptCATPersistStore function.

hProv

A handle to the cryptographic service provider (CSP).

dwEncodingType

A value that specifies the encoding type used for the file. Currently, only X509_ASN_ENCODING and PKCS_7_ASN_ENCODING are being used; however, additional encoding types may be added in the future. For either current encoding type, use: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

fdwStoreFlags

A bitwise combination of the following values.

ValueMeaning
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES
0x00010000

Exclude page hashes in SPC_INDIRECT_DATA.

CRYPTCAT_OPEN_FLAGS_MASK
0xffff0000

For all flags with a value in the upper word, set or clear the flag.

CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES
0x00020000

Include page hashes in SPC_INDIRECT_DATA. The CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES flag takes precedence if it is also set.

CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG
0x20000000

Open the file for decoding without detached content.

CRYPTCAT_OPEN_SORTED
0x40000000

Open the catalog with the entries sorted alphabetically by subject.

CRYPTCAT_OPEN_VERIFYSIGHASH
0x10000000

Verify the signature hash but not the certificate chain.

 

hReserved

This member is reserved and must be NULL.

hAttrs

This member is reserved and must be NULL.

hCryptMsg

A handle to the decoded bytes. This member is only set if the file was opened with the CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG flag set.

hSorted

This member is reserved and must be NULL.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Mscat.h

 

 

Community Additions

ADD
Show:
© 2014 Microsoft