ISCrdEnr interface
The ISCrdEnr interface represents the smart card enrollment control. It is primarily of interest to developers not using Automation. For programming in Visual Basic or another Automation language, see the CEnroll object.
Members
The ISCrdEnr interface inherits from the IDispatch interface. ISCrdEnr also has these types of members:
Methods
The ISCrdEnr interface has these methods.
| Method | Description |
|---|---|
| enroll | Requests a certificate on behalf of the user and stores the resulting certificate on the user's smart card. |
| enumCAName | Enumerates the names of the certification authorities (CAs) for a given certificate template name. |
| enumCertTemplateName | Enumerates the certificate template names. |
| enumCSPName | Enumerates the name of the available cryptographic service providers (CSPs). |
| getCACount | Returns the number of CAs willing to issue a certificate based on the specified certificate template. |
| getCAName | Retrieves the name of the specified CA for a given certificate template. |
| getCertTemplateCount | Retrieves the number of certificate templates. |
| getCertTemplateName | Retrieves the name of the certificate template. |
| getCertTemplateSMIME | Determine whether a certificate template contains the szOID_PKIX_KP_EMAIL_PROTECTION key usage. If this key usage is part of the certificate template, the certificate template supports Secure/Multipurpose Internet Mail Extensions (S/MIME) operations. |
| getEnrolledCertificateName | Retrieves the name of the certificate resulting from an earlier successful call to ISCrdEnr::enroll. This method can also be used to display the certificate in a dialog box. |
| getSigningCertificateName | Retrieves the subject name from the signing certificate. This method can also be used to display the certificate in a dialog box. |
| getUserName | Retrieves the name of the user on whose behalf the certificate enrollment is intended. |
| resetUser | Clears the user name from the smart card control. |
| selectSigningCertificate | Displays a Select Certificate dialog box allowing a signing certificate (also known as the enrollment agent certificate) to be selected. |
| selectUserName | Displays a Select User dialog box allowing a user name to be selected. The user name applies to the user on whose behalf the certificate enrollment is intended. |
| setCAName | Specifies the name of the CA. |
| setCertTemplateName | Specifies the name of the certificate template. |
| setSigningCertificate | Specifies a signing certificate (also known as the enrollment agent certificate). |
| setUserName | Specifies the name of the user on whose behalf the certificate enrollment is intended. |
Properties
The ISCrdEnr interface has these properties.
| Property | Access type | Description |
|---|---|---|
| CSPCount |
Read-only |
Specifies the number of CSPs. This property is read-only. |
| CSPName |
Read/write |
The name of the CSP. This property is read/write. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2003 [desktop apps only] |
| DLL |
|
| IID |
IID_ISCrdEnr is defined as 753988a1-1357-436d-9cf5-f089bdd67d64 |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for