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
Scrdenrl.dll
IID
IID_ISCrdEnr is defined as 753988a1-1357-436d-9cf5-f089bdd67d64