Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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

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

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.