ISCrdEnr::setSigningCertificate-Methode

Die setSigningCertificate-Methode gibt ein Signaturzertifikat an (auch als Registrierungs-Agent-Zertifikat bezeichnet).

Bevor Sie sich im Namen von Benutzern registrieren, müssen Sie ein Signaturzertifikat auswählen oder festlegen. 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 setSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);

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

Parameter

dwFlags [ In]

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

bstrCertTemplateName [ In]

Name der Zertifikatvorlage für das Signaturzertifikat. 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 bei der Methode ein Fehler auftritt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste der allgemeinen Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Bemerkungen

Bevor Sie sich im Auftrag eines Benutzers registrieren, müssen Sie zunächst ein Signaturzertifikat abrufen. Sie können ein Signaturzertifikat mithilfe des MMC-Snap-Ins des Zertifikat-Managers abrufen. Die setSigningCertificate-Methode erhält das Signaturzertifikat nicht, sondern informiert das Smartcard-Registrierungssteuersystem, das zuvor das zu verwendende Signaturzertifikat erhalten hat. Die setSigningCertificate-Methode durchsucht den Speicher "My" des Aufrufers nach dem neuesten Signaturzertifikat, das der von bstrCertTemplateName angegebenen Zertifikatvorlage entspricht.

Eine Alternative zu setSigningCertificate ist ISCrdEnr::setSigningCertificate.

Nachdem ein Signaturzertifikat festgelegt wurde, kann sein Name durch Aufrufen von ISCrdEnr::getSigningCertificateName abgerufen werden.

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::getSigningCertificateName