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-FunktionCertGetNameString auf.

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 ist (definiert als 0x01), 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 verwendet, um die Zertifikatanforderung zu signieren.

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 Namen des Signaturzertifikats darstellt. Das Signaturzertifikat wird verwendet, um die Zertifikatanforderung zu signieren.

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::setSigningCertificate ausgewä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 wird.

Anforderungen

Siehe auch

ISCrdEnr

ISCrdEnr::selectSigningCertificate