ICspStatus::p ut_Ordinal-Methode (certenroll.h)
Die Ordinal-Eigenschaft gibt die Position des ICspStatus-Objekts in der ICspStatuses-Auflistung an oder ruft sie ab.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_Ordinal(
LONG Value
);
Parameter
Value
Rückgabewert
Keine
Bemerkungen
Um die ICspStatuses-Auflistung nach Ordnungszahl zu durchlaufen, rufen Sie die ItemByOrdinal-Eigenschaft auf. Die Ordnungsreihenfolge der ICspStatus-Objekte in der Auflistung kann jedes Mal variieren, wenn die Auflistung aufgezählt wird, aus verschiedenen Gründen, einschließlich, aber nicht beschränkt auf:
- Einstellungen für Zertifikatanforderungsvorlagen
- Eigenschaftswerte für den Kryptografieanbieter
- Eigenschaftswerte des privaten Schlüssels
Angenommen, die Vorlage version 2, die zum Erstellen einer Zertifikatanforderung ausgewählt wurde, gibt an, dass das Zertifikat nur zum Signieren verwendet werden kann (das pKIDefaultKeySpec-Vorlagenattribute ist XCN_AT_SIGNATURE), und dass der Standardanbieter der Microsoft Enhanced RSA and AES Cryptographic Provider ist. Beachten Sie, dass die Vorlage das Zertifikat auf die Signatur beschränkt, obwohl der Anbieter sowohl Verschlüsselungs- als auch Signaturalgorithmen unterstützt. Das heißt, die KeySpec-Eigenschaft des Anbieters ist eine bitweise Kombination der XCN_AT_KEYEXCHANGE und XCN_AT_SIGNATURE Konstanten, aber das pKIDefaultKeySpec-Vorlagenattribute unterstützt nur XCN_AT_SIGNATURE.
Die ICspStatus-Objekte in der Auflistung werden wie folgt sortiert:
- Von den ICspStatus-Objekten , die für diesen Anbieter aufgelistet sind, werden diejenigen, die Signaturalgorithmen (XCN_AT_SIGNATURE) zugeordnet sind, zuerst sortiert (niedrigerer Ordnungswert), und ihre Eigenschaften Display und Selected sind aktiviert. Hinweis Wenn das pKIDefaultKeySpec-Vorlagenattribute XCN_AT_KEYEXCHANGE worden wäre, würden die Verschlüsselungsalgorithmen zuerst sortiert.
- Von den ICspStatus-Objekten , die für diesen Anbieter aufgelistet sind, werden die mit Verschlüsselungsalgorithmen (XCN_AT_KEYEXCHANGE) verknüpften Objekte später sortiert (höhere Ordnungswerte), und ihre Eigenschaften Display und Selected sind nicht aktiviert.
- Für alle anderen installierten CryptoAPI-Anbieter, die asymmetrische Signaturalgorithmen (XCN_AT_SIGNATURE) unterstützen, die jedoch nicht dem angegebenen Anbieter zugeordnet sind, ist die Display-Eigenschaft aktiviert, und die Selected-Eigenschaft ist nicht aktiviert.
- Für alle anderen installierten CryptoAPI-Anbieter, die asymmetrische Verschlüsselungsalgorithmen (XCN_AT_KEYEXCHANGE) unterstützen, sind die Eigenschaften Display und Selected nicht aktiviert.
- Für alle installierten CNG-Anbieter (Cryptography API: Next Generation) sind die Eigenschaften Display und Selected nicht aktiviert.
Für ein weiteres Beispiel wird davon ausgegangen, dass eine Vorlage der Version 3 einen bestimmten CNG-Anbieter und -Algorithmus angibt. Dieses Anbieter-Algorithmus-Paar (ICspStatus-Objekt ) wird zuerst sortiert, für die Anzeige aktiviert und ausgewählt. Alle anderen Algorithmen, die von diesem Anbieter unterstützt werden, werden später bestellt, nicht für die Anzeige aktiviert und nicht ausgewählt. Alle anderen Anbieter, die den angegebenen Algorithmus unterstützen, werden später noch bestellt, für die Anzeige aktiviert, aber nicht ausgewählt. Alle verbleibenden Anbieter-Algorithmus-Paare werden nicht für die Anzeige aktiviert und nicht ausgewählt.
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 |