ISCrdEnr::getSigningCertificateName-Methode
Die getSigningCertificateName-Methode ruft den Antragstellernamen aus dem Signaturzertifikat ab.
Diese Methode kann auch verwendet werden, um das Zertifikat in einem Dialogfeld anzuzeigen. Diese Methode ruft die CryptoAPI-Funktion CertGetNameStringauf.
Syntax
HRESULT getSigningCertificateName(
[in] DWORD dwFlags,
[out] BSTR *pbstrSigningCertName
);
SCrdEnr.getSigningCertificateName( _
ByVal dwFlags, _
ByRef pbstrSigningCertName _
)
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 Signaturzertifikat nicht angezeigt. Alle anderen Werte führen dazu, dass das Signaturzertifikat im Dialogfeld Zertifikat angezeigt wird.
-
pbstrSigningCertName [ out]
-
Ein Zeiger auf eine Zeichenfolge, die den Namen des Signaturzertifikats zurückgibt. Das Signaturzertifikat wird zum Signieren der Zertifikatanforderungverwendet.
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 Namen des Signaturzertifikats darstellt. Das Signaturzertifikat wird zum Signieren der Zertifikatanforderungverwendet.
Bemerkungen
Die getSigningCertificateName-Methode gibt den Antragstellernamen des Zertifikats zurück, das Sie (oder ein anderer Administrator) in einem vorherigen erfolgreichen Aufruf von ISCrdEnr::selectSigningCertificate oder ISCrdEnr::setSigningCertificateausgewählt haben. Diese Methode ruft die CertGetNameString-Funktion auf, um den Antragstellernamen 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 |
|
| IID |
IID _ ISCrdEnr ist als 753988a1-1357-436d-9cf5-f089bdd67d64 definiert. |