CERT_SIMPLE_CHAIN structure (wincrypt.h)

The CERT_SIMPLE_CHAIN structure contains an array of chain elements and a summary trust status for the chain that the array represents.

Syntax

typedef struct _CERT_SIMPLE_CHAIN {
  DWORD                 cbSize;
  CERT_TRUST_STATUS     TrustStatus;
  DWORD                 cElement;
  PCERT_CHAIN_ELEMENT   *rgpElement;
  PCERT_TRUST_LIST_INFO pTrustListInfo;
  BOOL                  fHasRevocationFreshnessTime;
  DWORD                 dwRevocationFreshnessTime;
} CERT_SIMPLE_CHAIN, *PCERT_SIMPLE_CHAIN;

Members

cbSize

The size, in bytes, of this structure.

TrustStatus

A structure that indicates the trust status of the whole chain. The structure includes an error status code and an information status code. For information about status code values, see CERT_TRUST_STATUS.

cElement

The number of CERT_CHAIN_ELEMENT structures in the array.

rgpElement

An array of pointers to CERT_CHAIN_ELEMENT structures. rgpElement[0] is the end certificate chain element. rgpElement[cElement–1] is the self-signed "root" certificate element.

pTrustListInfo

A pointer to a CERT_TRUST_LIST_INFO structure that contains a pointer to a certificate trust list (CTL) connecting this chain to a next certificate chain. If the current chain is the final chain, pTrustListInfo is NULL.

fHasRevocationFreshnessTime

BOOL. If TRUE, dwRevocationFreshnessTime has been calculated.

dwRevocationFreshnessTime

The age of a certificate revocation list (CRL) in seconds, calculated as the CurrentTime minus the CRL's ThisUpdate time. This values is the largest time across all elements checked.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h

See also

CERT_CHAIN_CONTEXT

CERT_CHAIN_ELEMENT

CERT_TRUST_LIST_INFO

CERT_TRUST_STATUS