IEnroll::p ut_HashAlgorithmWStr-Methode (xenroll.h)
[Diese Eigenschaft steht ab Windows Server 2008 und Windows Vista nicht mehr zur Verfügung.]
Die HashAlgorithmWStr-Eigenschaft legt oder ruft nur den Signaturhashalgorithmus ab, der zum Signieren der PKCS #10-Zertifizierungsanforderung verwendet wird.
Diese Eigenschaft wurde zuerst in der IEnroll-Schnittstelle definiert.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_HashAlgorithmWStr(
LPWSTR szw
);
Parameter
szw
Rückgabewert
Keine
Bemerkungen
Dieser Signaturhashalgorithmus ist nicht mit dem Hashalgorithmus zu verwechseln, der zum Signieren des Zertifikats verwendet wird. Das Registrierungssteuerelement unterstützt derzeit alle OID für Hashalgorithmen sowie die folgenden Anzeigenamenwerte: SHA1 (Standard), MD2 und MD5. Beim Abrufen dieser Eigenschaft befindet sich der abgerufene Wert im OID-Format (SHA1 wird als 1.3.14.3.2.2.29 angezeigt). Beim Festlegen dieser Eigenschaft kann das entsprechende OID-Format als Alternative zum Text verwendet werden, der für die definierten Anzeigewerte angezeigt wird.
Das Zertifikatregistrierungssteuerelement betrachtet den Wert der HashAlgorithmWStr-Eigenschaft als Hinweis auf den Hashingalgorithmus, der zum Signieren der PKCS #10-Zertifizierungsanforderung verwendet werden soll. Wenn der Kryptografiedienstanbieter (Cryptographic Service Provider , CSP) den in der HashAlgorithmWStr-Eigenschaft angegebenen Algorithmus unterstützt, wird der Algorithmus verwendet. Andernfalls versucht das Zertifikatregistrierungssteuerelement, SHA1 zu verwenden. Wenn SHA1 vom CSP nicht unterstützt wird, wird MD5 versucht. Wenn weder SHA1 noch MD5 unterstützt werden, versucht das Zertifikatregistrierungssteuerelement, den ersten vom CSP zurückgegebenen Hashingalgorithmus zu verwenden.
Die HashAlgorithmWStr-Eigenschaft wirkt sich auf das Verhalten der folgenden Methoden aus:
Wenn sowohl die HashAlgID - als auch die HashAlgorithmWStr-Eigenschaft festgelegt sind, gibt der zuletzt aktualisierte Hashalgorithmus an, um die PKCS #10-Zertifizierungsanforderung zu signieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xenroll.h |
| Bibliothek | Uuid.lib |
| DLL | Xenroll.dll |