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 für ein Authentifizierungsgerät, z. B. einen Fingerabdruckleser.

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 Authentifizierungsgerät ist verfügbar.
DeviceBusy	4	Das Authentifizierungsgerät führt einen Vorgang aus und ist nicht verfügbar.
DeviceNotPresent	1	Es ist kein Authentifizierungsgerät verfügbar.
DisabledByPolicy	3	Die Gruppenrichtlinie hat das Authentifizierungsgerät deaktiviert.
NotConfiguredForUser	2	Ein Authentifizierungsgerät ist für diesen Benutzer nicht konfiguriert.

Beispiele

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

public async System.Threading.Tasks.Task<string> CheckDeviceAvailability()
{
    string returnMessage;

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

    switch (ucvAvailability)
    {
        case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.Available:
            returnMessage = "Authentication device is available.";
            break;
        case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.DeviceBusy:
            returnMessage = "Authentication device is busy.";
            break;
        case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.DeviceNotPresent:
            returnMessage = "No authentication device found.";
            break;
        case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.DisabledByPolicy:
            returnMessage = "Authentication device verification is disabled by policy.";
            break;
        case Windows.Security.Credentials.UI.UserConsentVerifierAvailability.NotConfiguredForUser:
            returnMessage = "Please go to Account Settings to set up a PIN or other advanced authentication.";
            break;
        default:
            returnMessage = "Authentication device is currently unavailable.";
            break;
    }

    return returnMessage;
}

Hinweise

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

Gilt für:

Freigeben über