ISCrdEnr::selectSigningCertificate, méthode

La méthode selectSigningCertificate affiche une boîte de dialogue Sélectionner un certificat , ce qui permet de sélectionner un certificat de signature (également appelé certificat d’agent d’inscription).

Avant de vous inscrire pour le compte des utilisateurs, vous devez sélectionner un certificat de signature. La clé privée associée à ce certificat de signature est utilisée pour signer une demande PKCS #7. Le PKCS #7, à son tour, contient la requête PKCS #10 de l’utilisateur (qui est signée avec la clé privée de l’utilisateur).

Syntaxe

HRESULT selectSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);

SCrdEnr.selectSigningCertificate( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName _
)

Paramètres

dwFlags [in]

Réservé pour un usage futur. Définissez cette valeur sur zéro.

bstrCertTemplateName [in]

Chaîne qui représente le nom du modèle de certificat pour le certificat de signature. Vous pouvez utiliser la valeur « EnrollmentAgent » si vous avez obtenu un certificat EnrollmentAgent.

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

Avant de vous inscrire pour le compte d’un utilisateur, vous devez d’abord obtenir un certificat de signature. Vous pouvez obtenir un certificat de signature à l’aide du composant logiciel enfichable MMC Gestionnaire de certificats. La méthode selectSigningCertificate n’obtient pas le certificat de signature, mais affiche une boîte de dialogue des certificats de signature obtenus précédemment, ce qui vous permet de choisir le certificat qui sera utilisé pour signer les demandes d’inscription de la part.

Une alternative à selectSigningCertificate est ISCrdEnr::setSigningCertificate.

Une fois qu’un certificat de signature est sélectionné, son nom peut être récupéré en appelant ISCrdEnr::getSigningCertificateName.

Spécifications

Voir aussi

ISCrdEnr

ISCrdEnr::getSigningCertificateName