ISCrdEnr::selectSigningCertificate-Methode

Die selectSigningCertificate-Methode zeigt ein Dialogfeld Zertifikat auswählen an, in dem ein Signaturzertifikat (auch als Registrierungs-Agent-Zertifikat bezeichnet) ausgewählt werden kann.

Bevor Sie sich im Namen von Benutzern registrieren, müssen Sie ein Signaturzertifikat auswählen. Der private Schlüssel , der diesem Signaturzertifikat zugeordnet ist, wird zum Signieren einer PKCS #7-Anforderung verwendet. PkCS #7 enthält wiederum die PKCS #10-Anforderung des Benutzers (die mit dem privaten Schlüssel des Benutzers signiert ist).

Syntax

HRESULT selectSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);

SCrdEnr.selectSigningCertificate( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName _
)

Parameter

dwFlags [in]

Für die zukünftige Verwendung reserviert. Legen Sie diesen Wert auf 0 (null) fest.

bstrCertTemplateName [in]

Eine Zeichenfolge, die den Namen der Zertifikatvorlage für das Signaturzertifikat darstellt. Sie können den Wert "EnrollmentAgent" verwenden, wenn Sie ein EnrollmentAgent-Zertifikat erhalten haben.

Rückgabewert

VB

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.

Bemerkungen

Bevor Sie sich im Namen eines Benutzers registrieren, müssen Sie zunächst ein Signaturzertifikat abrufen. Sie können ein Signaturzertifikat mithilfe des MMC-Snap-Ins Zertifikat-Manager abrufen. Die selectSigningCertificate-Methode ruft das Signaturzertifikat nicht ab, zeigt jedoch ein Dialogfeld mit zuvor abgerufenen Signaturzertifikaten an, mit dem Sie auswählen können, welches Zertifikat zum Signieren der Registrierungs-im-Behalf-Anforderungen verwendet wird.

Eine Alternative zu selectSigningCertificate ist ISCrdEnr::setSigningCertificate.

Nachdem ein Signaturzertifikat ausgewählt wurde, kann sein Name abgerufen werden, indem ISCrdEnr::getSigningCertificateName aufgerufen wird.

Anforderungen

Siehe auch

ISCrdEnr

ISCrdEnr::getSigningCertificateName