ISCrdEnr::getSigningCertificateName, méthode

Article
06/13/2023

La méthode getSigningCertificateName récupère le nom de l’objet à partir du certificat de signature.

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 getSigningCertificateName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrSigningCertName
);


SCrdEnr.getSigningCertificateName( _
  ByVal dwFlags, _
  ByRef pbstrSigningCertName _
)

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 de signature n’est pas affiché ; toutes les autres valeurs entraînent l’affichage du certificat de signature dans la boîte de dialogue Certificat .
pbstrSigningCertName [out]: Pointeur vers une chaîne qui retourne le nom du certificat de signature. Le certificat de signature sera utilisé pour signer la demande de certificat.

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 de signature. Le certificat de signature sera utilisé pour signer la demande de certificat.

Notes

La méthode getSigningCertificateName retourne le nom d’objet du certificat que vous (ou un autre administrateur) avez sélectionné lors d’un appel réussi précédent à ISCrdEnr::selectSigningCertificate ou ISCrdEnr::setSigningCertificate. Cette méthode appelle la fonction CertGetNameString pour récupérer le nom du sujet 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::selectSigningCertificate

Partager via