CRYPTCATSTORE structure (mscat.h)

[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.

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