ISCrdEnr::getEnrolledCertificateName-Methode

Die getEnrolledCertificateName-Methode ruft den Namen des Zertifikats ab, der sich aus einem früheren erfolgreichen Aufruf von ISCrdEnr::enrollergibt.

Diese Methode kann auch verwendet werden, um das Zertifikat in einem Dialogfeld anzuzeigen. Diese Methode ruft die CryptoAPI-Funktion CertGetNameStringauf.

Syntax

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

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

Parameter

dwFlags [ In]

Ein -Wert, der bestimmt, ob das Zertifikat in einem Dialogfeld angezeigt wird. Wenn dieser Wert SCARD _ ENROLL _ NO DISPLAY _ _ CERT ist (definiert als 0x01), wird das registrierte Zertifikat nicht angezeigt. Alle anderen Werte bewirken, dass das registrierte Zertifikat im Dialogfeld Zertifikat angezeigt wird.

pBstrCertName [ out]

Ein Zeiger auf eine Zeichenfolge, die den abgerufenen Zertifikatnamen zurückgibt.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S _ OK zurück.

Wenn die Methode fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste der allgemeinen Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Eine Zeichenfolge, die den abgerufenen Zertifikatnamen darstellt.

Bemerkungen

Da diese Methode für ein vorhandenes Zertifikat verwendet wird, müssen Sie ISCrdEnr::enroll erfolgreich aufgerufen haben, bevor Sie getEnrolledCertificateName aufrufen können.

Die getEnrolledCertificateName-Methode ruft die CertGetNameString-Funktion auf, um den Zertifikatnamen gemäß der Sequenz abzurufen, die für den CERT _ NAME SIMPLE DISPLAY _ _ _ TYPE-Wert des dwType-Parameters von CertGetNameString beschrieben ist.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Nicht unterstützt
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
DLL
Scrdenrl.dll
IID
IID _ ISCrdEnr ist als 753988a1-1357-436d-9cf5-f089bdd67d64 definiert.

Weitere Informationen

ISCrdEnr

ISCrdEnr::enroll