Edit

Methods of ISCrdEnr

  • Article

The methods introduced by ISCrdEnr are listed in the following table.

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 certification authorities (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 Determines if 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. This method calls the CryptoAPI function CertGetNameString.
getSigningCertificateName Retrieves the subject name from the signing certificate. This method can also be used to display the certificate in a dialog box. This method calls the CryptoAPI function CertGetNameString.
getUserName Retrieves the name of the user on whose behalf the certificate enrollment is intended. Before calling this method, you must specify the user name in a call to ISCrdEnr::selectUserName or ISCrdEnr::setUserName.
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. Before enrolling on behalf of users, you must select a signing certificate. The private key associated with this signing certificate is used to sign a PKCS #7 request. The PKCS #7, in turn, contains the user's PKCS #10 request (which is signed with the user's private key).
selectUserName Displays a Select User interface, 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). Before enrolling on behalf of users, you must select or set a signing certificate. The private key associated with this signing certificate is used to sign a PKCS #7 request. The PKCS #7, in turn, contains the user's PKCS #10 request (which is signed with the user's private key).
setUserName Specifies the name of the user on whose behalf the certificate enrollment is intended.