UserConsentVerifierAvailability Enumeration

Referenz

Definition

Namespace:: Windows.Security.Credentials.UI

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Beschreibt das Ergebnis einer Überprüfung auf ein biometrisches Gerät (Fingerabdruck)-Prüfgerät.

public enum class UserConsentVerifierAvailability

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class UserConsentVerifierAvailability

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum UserConsentVerifierAvailability

var value = Windows.Security.Credentials.UI.UserConsentVerifierAvailability.available

Public Enum UserConsentVerifierAvailability

Vererbung: Enum
UserConsentVerifierAvailability

Attribute: ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

Available	0	Ein biometrisches Prüfgerät ist verfügbar.
DeviceBusy	4	Das biometrische Prüfgerät führt einen Vorgang aus und ist nicht verfügbar.
DeviceNotPresent	1	Es ist kein biometrisches Prüfgerät verfügbar.
DisabledByPolicy	3	Die Gruppenrichtlinie hat das Gerät für die biometrische Überprüfung deaktiviert.
NotConfiguredForUser	2	Ein biometrisches Prüfgerät ist für diesen Benutzer nicht konfiguriert.

Beispiele

Das folgende Beispiel zeigt eine Methode, die überprüft, ob die Fingerabdruckauthentifizierung für den aktuellen Computer unterstützt wird, und gibt eine Meldung zurück, die das Ergebnis basierend auf dem Wert UserConsentVerifierAvailability beschreibt.

public async System.Threading.Tasks.Task<string> CheckFingerprintAvailability()
{
    string returnMessage = "";

    try
    {
        // Check the availability of fingerprint authentication.
        var ucvAvailability = await Windows.Security.Credentials.UI.UserConsentVerifier.CheckAvailabilityAsync();

        switch (ucvAvailability)
        {
            case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.Available:
                returnMessage = "Fingerprint verification is available.";
                break;
            case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.DeviceBusy:
                returnMessage = "Biometric device is busy.";
                break;
            case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.DeviceNotPresent:
                returnMessage = "No biometric device found.";
                break;
            case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.DisabledByPolicy:
                returnMessage = "Biometric verification is disabled by policy.";
                break;
            case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.NotConfiguredForUser:
                returnMessage = "The user has no fingerprints registered. Please add a fingerprint to the " +
                                "fingerprint database and try again.";
                break;
            default:
                returnMessage = "Fingerprints verification is currently unavailable.";
                break;
        }
    }
    catch (Exception ex)
    {
        returnMessage = "Fingerprint authentication availability check failed: " + ex.ToString();
    }

    return returnMessage;
}

Hinweise

Sie können die CheckAvailabilityAsync-Methode verwenden, um zu bestimmen, ob die Fingerabdruckauthentifizierung für den aktuellen Computer unterstützt wird.

Gilt für: