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 |
|
| IID |
IID _ ISCrdEnr ist als 753988a1-1357-436d-9cf5-f089bdd67d64 definiert. |