IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL (winbio_ioctl.h)
Die IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS IOCTL ruft eine Liste kryptografischer Hashalgorithmen ab, die vom Gerät unterstützt werden. Diese IOCTL ist optional.
Hauptcode
Eingabepuffer
Keine.
Eingabepufferlänge
Keine.
Ausgabepuffer
AssociatedIrp. SystemBuffer-Member zeigt auf einen Puffer, der eine WINBIO_SUPPORTED_ALGORITHMS-Struktur enthält.
Länge des Ausgabepuffers
Die kleinste gültige Ausgabepuffergröße ist die Größe von DWORD. Wenn der Treiber einen Ausgabepuffer in DWORD-Größe empfängt, sollte der Treiber die für den angeforderten Vorgang erforderliche Puffergröße zurückgeben.
Statusblock
Gibt an, ob der DeviceIoControl-Aufruf des Treibers abgeschlossen wurde und die OUT-Nutzlast gültig ist.
Das Statuselement ist auf einen der Werte in der folgenden Tabelle festgelegt.
| Statuswert | BESCHREIBUNG |
|---|---|
| S_OK, STATUS_SUCCESS | Der Vorgang wurde erfolgreich abgeschlossen. Wenn die Größe der zurückgegebenen Daten DWORD ist, enthält die Nutzlast die Größe des Puffers, der für den Aufruf erforderlich ist. Andernfalls enthält die Nutzlast den vollständigen Ausgabepuffer. |
| E_INVALIDARG | Die Parameter wurden nicht ordnungsgemäß angegeben. |
| E_UNKNOWN | Jeder andere Fehler, der verhindert, dass die Nutzlast eingegeben wird. |
| E_UNEXPECTED | Jeder andere Fehler, der verhindert, dass die Nutzlast eingegeben wird. |
| E_FAIL | Jeder andere Fehler, der verhindert, dass die Nutzlast eingegeben wird. |
Hinweise
Die Algorithmen werden mithilfe von NULL-beendeten UTF-8-codierten Zeichenfolgen angegeben. Die Algorithmusbezeichner "OID"-Zeichenfolgen werden in RFC 3279 und RFC 3278 definiert.
Hier finden Sie Beispiele für OID-Zeichenfolgen für Hashalgorithmen.
| Algorithmus | Algorithmusbezeichnerzeichenfolge |
|---|---|
| SHA-1 | "1.3.14.3.2.26" |
| SHA-256 | "2.16.840.1.101.3.4.2.1" |
| SHA-384 | "2.16.840.1.101.3.4.2.2" |
| SHA-512 | "2.16.840.1.101.3.4.2.3" |
IOCTL_BIOMETRIC_GET_SUPPORTED_ALGORITHMS muss implementiert werden, wenn das Gerät WINBIO_CAPABILITY_SECURE_STORAGE unterstützt. Das Gerät muss mindestens SHA-1 ("1.3.14.3.2.26") unterstützen, um zum Speichern von WinBio-Vorlagen verwendet zu werden.
Wenn der vom Hersteller bereitgestellte Treiber die gesamte Nutzlast zurückgibt, sollte er das WinBioHresult-Mitglied von WINBIO_SUPPORTED_ALGORITHMS mit dem Status des biometrischen Vorgangs ausfüllen.
Mögliche Werte sind:
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Kopfzeile | winbio_ioctl.h |