IEnroll::get_HashAlgorithmWStr-Methode (xenroll.h)
[Diese Eigenschaft ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]
Die HashAlgorithmWStr-Eigenschaft legt oder ruft nur den Signaturhashingalgorithmus 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 get_HashAlgorithmWStr(
LPWSTR *szw
);
Parameter
szw
Rückgabewert
Keine
Bemerkungen
Dieser Signaturhashingalgorithmus ist nicht mit dem Hashalgorithmus zu verwechseln, der zum Signieren des Zertifikats verwendet wird. Das Registrierungssteuerelement unterstützt derzeit jede OID für Hashingalgorithmen sowie die folgenden Anzeigenamenwerte: SHA1 (Standard), MD2 und MD5. Beim Abrufen dieser Eigenschaft hat der abgerufene Wert das OID-Format (SHA1 wird also als 1.3.14.3.2.29 angezeigt). Wenn Sie diese Eigenschaft festlegen, 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 Hashalgorithmus, 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 die Zertifikatregistrierungssteuerung, SHA1 zu verwenden. Wenn SHA1 vom CSP nicht unterstützt wird, wird MD5 versucht. Wenn weder SHA1 noch MD5 unterstützt wird, versucht die Zertifikatregistrierungssteuerung, den ersten vom CSP zurückgegebenen Hashingalgorithmus zu verwenden.
Die HashAlgorithmWStr-Eigenschaft wirkt sich auf das Verhalten der folgenden Methoden aus:
Wenn sowohl die Eigenschaften HashAlgID als auch HashAlgorithmWStr festgelegt sind, gibt der zuletzt aktualisierte Hashalgorithmus an, der zum Signieren der PKCS #10-Zertifizierungsanforderung verwendet wird.
Anforderungen
| 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 |