IChain2::Build method

[CAPICOM is a 32-bit only component that is available for use in the following operating systems: Windows Server 2008, Windows Vista, and Windows XP. Instead, use the X509Chain Class in the System.Security.Cryptography.X509Certificates namespace.]

The Build method builds a certificate verification chain from an end certificate to the trusted root certificate and returns a Boolean value that indicates the overall validity of the chain.


Chain.Build( _
  ByVal Certificate _


Certificate [in]

A Certificate object that represents the end certificate upon which the verification chain is to be built.

Return value

A Boolean value that indicates the overall validity of the chain. Overall validity is based on the validity checking policy in place.


The chain is built using the CertificateStatus.CheckFlag property as well as application and certificate policies specified by a CertificateStatus object. The returned collection is ordered; the first certificate in the collection, Certificates.Item(1), is the end certificate of the chain. The last certificate in the collection, Certificates.Item(Certificates.Count), is the root certificate of the chain. Certificates.Item(0) represents the entire chain.

Each time the Chain.Build method is called, the state of the Chain object is reset.


End of client support

Windows Vista

End of server support

Windows Server 2008


CAPICOM 2.0 or later on Windows Server 2003 and Windows XP



See also

Cryptography Objects