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 |
|