CERT_CHAIN_CONTEXT

This structure contains an array of simple certificate chains and a trust status structure that indicates summary validity data on all of the connected simple chains.

typedef struct _CERT_CHAIN_CONTEXT {
DWORD cbSize;
CERT_TRUST_STATUS TrustStatus;
DWORD cChain;
PCERT_SIMPLE_CHAIN* rgpChain;
} CERT_CHAIN_CONTEXT,  *PCERT_CHAIN_CONTEXT;

Members

• cbSize **
  Size of this structure in bytes.
• TrustStatus **
  Structure that indicates the combined trust status of the simple chains array. The structure includes an error status code and an information status code. For information on status code values, see the CERT_TRUST_STATUS structure.
• cChain **
  Number of simple chains in the array.
• rgpChain **
  Array of simple chain structures; rgpChain[0] is the end certificate simple chain and rgpChain[cChain-1] is the final chain. If the end certificate is to be considered valid, the final chain must begin with a certificate contained in the root store or an otherwise trusted, self-signed certificate. If the original chain begins with a trusted certificate, there will be only a single simple chain in the array.

Remarks

When a CERT_CHAIN_CONTEXT structure is built, the first simple chain begins with an end certificate and ends with a self-signed certificate. If that self-signed certificate is not a root or otherwise trusted certificate, an attempt is made to build a new chain. This process continues building additional simple chains until the first self-signed certificate is a trusted certificate or until an additional simple chain cannot be built.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	3.0 or later	Wincrypt.h

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CertGetCertificateChain, CERT_SIMPLE_CHAIN, CERT_TRUST_STATUS

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.