ICspStatus::get_EnrollmentStatus-Methode (certenroll.h)
Die EnrollmentStatus-Eigenschaft ruft ein IX509EnrollmentStatus-Objekt ab, das Informationen zur Zertifikatregistrierung enthält.
Diese Eigenschaft ist schreibgeschützt.
Syntax
HRESULT get_EnrollmentStatus(
IX509EnrollmentStatus **ppValue
);
Parameter
ppValue
Rückgabewert
Keine
Bemerkungen
Diese Eigenschaft gibt ein IX509EnrollmentStatus-Objekt zurück. Dieses Objekt wird in der Regel aufgefüllt, wenn Sie eine PKCS #10-Zertifikatanforderung erstellen. Die folgenden drei Eigenschaften, die von diesem Objekt zurückgegeben werden, stellen Informationen über das Anbieter-Algorithmus-Paar bereit, das durch ein ICspStatus-Objekt dargestellt wird:
- Die Display-Eigenschaft gibt an, ob der Anbieter und der Algorithmus in einer Benutzeroberfläche angezeigt werden sollen.
- Die Selected-Eigenschaft gibt an, ob der Anbieter und der Algorithmus zum Erstellen eines Schlüsselpaars für eine Zertifikatanforderung verwendet werden können.
- Die Status-Eigenschaft gibt an, ob der Anbieter und der Algorithmus während der Anforderungsinitialisierung übersprungen wurden oder zu einem Fehler geführt haben.
Angenommen, eine Zertifikatanforderung basiert auf einer Vorlage, die einen bestimmten Anbieter und Algorithmus angibt, um zu verstehen, wie wichtig diese Eigenschaften sind. Die Eigenschaften Anzeige und Status für dieses Anbieter/Algorithmus-Paar sind aktiviert. Für andere ICspStatus-Objekte sind möglicherweise eine oder beide dieser Eigenschaften nicht aktiviert. Ausführlichere Beispiele finden Sie in der Ordinal-Eigenschaft .
Die Status-Eigenschaft ist auf EnrollUnknown festgelegt, wenn das IX509EnrollmentStatus-Objekt zum ersten Mal erstellt wird. Wenn kein Anbieter/Algorithmus-Paar ausgewählt ist, kann die status auf EnrollSkipped festgelegt werden. Die status wird auf EnrollError festgelegt, wenn die Schlüsselerstellung für den ausgewählten Anbieter und Algorithmus während der Zertifikatinitialisierung fehlschlägt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certenroll.h |
| DLL | CertEnroll.dll |