ICertificates2::Select 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 X509Certificate2Collection Class in the System.Security.Cryptography.X509Certificates namespace.]

The Select method displays a dialog box for selecting certificates and returns a collection of those certificates selected. This method was introduced in CAPICOM 2.0.

Syntax

Certificates.Select( _
  [ ByVal Title ], _
  [ ByVal DisplayString ], _
  [ ByVal bMultiSelect ] _
)

Parameters

Title [in, optional]

String that contains the title for the dialog box. The default value is an empty string ("").

DisplayString [in, optional]

String that contains the prompt text displayed with the dialog box. The default value is an empty string ("").

bMultiSelect [in, optional]

Boolean value that indicates whether the user can select more than one certificate. True indicates multiple certificates can be selected by using the CTRL or SHIFT key. The default value is false.

Return value

A Certificates object that contains the certificates selected from the dialog box.

CAPICOM 2.1: The Certificates object that is returned contains references to the certificates in the collection from which the selection was made. Any changes made to the certificates in the returned Certificates object are reflected in that collection.

CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2, and CAPICOM 2.0.0.3: The Certificates object that is returned contains copies of the certificates in the collection from which the selection was made. Any changes made to the certificates in the returned Certificates object are not reflected in that collection.

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