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.

Syntax

Chain.Build( _
  ByVal Certificate _
)

Parameters

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.

Remarks

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.

Requirements

Requirement Value
End of client support
Windows Vista
End of server support
Windows Server 2008
Redistributable
CAPICOM 2.0 or later on Windows Server 2003 and Windows XP
DLL
Capicom.dll

See also

Cryptography Objects

Chain