ISCrdEnr::getEnrolledCertificateName, méthode

Article
06/13/2023

La méthode getEnrolledCertificateName récupère le nom du certificat résultant d’un appel réussi antérieur à ISCrdEnr::enroll.

Cette méthode peut également être utilisée pour afficher le certificat dans une boîte de dialogue. Cette méthode appelle la fonction CryptoAPICertGetNameString.

Syntaxe

HRESULT getEnrolledCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pBstrCertName
);


SCrdEnr.getEnrolledCertificateName( _
  ByVal dwFlags, _
  ByRef pBstrCertName _
)

Paramètres

dwFlags [in]: Valeur qui détermine si le certificat est affiché dans une boîte de dialogue. Si cette valeur est SCARD_ENROLL_NO_DISPLAY_CERT (définie comme 0x01), le certificat inscrit n’est pas affiché ; toutes les autres valeurs entraînent l’affichage du certificat inscrit dans la boîte de dialogue Certificat .
pBstrCertName [out]: Pointeur vers une chaîne qui retourne le nom du certificat récupéré.

Valeur retournée

C++

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.

VB

Chaîne qui représente le nom du certificat récupéré.

Notes

Étant donné que cette méthode fonctionne sur un certificat existant, vous devez avoir correctement appelé ISCrdEnr::enroll pour pouvoir appeler getEnrolledCertificateName.

La méthode getEnrolledCertificateName appelle la fonction CertGetNameString pour récupérer le nom du certificat en fonction de la séquence décrite pour la valeur CERT_NAME_SIMPLE_DISPLAY_TYPE du paramètre dwType de CertGetNameString.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
DLL	Scrdenrl.dll
IID	IID_ISCrdEnr est défini comme 753988a1-1357-436d-9cf5-f089bdd67d64

Voir aussi

ISCrdEnr
ISCrdEnr::enroll

Partager via