ISCrdEnr::getEnrolledCertificateName-Methode
Die getEnrolledCertificateName-Methode ruft den Namen des Zertifikats ab, das sich aus einem früheren erfolgreichen Aufruf von ISCrdEnr::enroll ergibt.
Diese Methode kann auch verwendet werden, um das Zertifikat in einem Dialogfeld anzuzeigen. Diese Methode ruft die CryptoAPI-FunktionCertGetNameString auf.
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 (definiert als 0x01) ist, wird das registrierte Zertifikat nicht angezeigt. alle anderen Werte führen dazu, 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, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
VB
Eine Zeichenfolge, die den abgerufenen Zertifikatnamen darstellt.
Bemerkungen
Da diese Methode für ein vorhandenes Zertifikat ausgeführt 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 wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nicht unterstützt |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|
| IID |
IID_ISCrdEnr ist definiert als 753988a1-1357-436d-9cf5-f089bdd67d64 |
Siehe auch