次の方法で共有

UserConsentVerifierAvailability 列挙型

  • リファレンス

定義

名前空間:
Windows.Security.Credentials.UI
編集

指紋リーダーなどの認証デバイスのチェックの結果について説明します。

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
継承
Enum
UserConsentVerifierAvailability
属性
ContractVersionAttribute

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

フィールド

名前 値 説明
Available 0

認証デバイスを使用できます。
DeviceBusy 4

認証デバイスが操作を実行しており、使用できません。
DeviceNotPresent 1

使用できる認証デバイスはありません。
DisabledByPolicy 3

グループ ポリシーによって認証デバイスが無効にされました。
NotConfiguredForUser 2

このユーザーに対して認証デバイスが構成されていません。

例

次の例は、現在のユーザーに対して認証デバイスがサポートされているかどうかを確認し、UserConsentVerifierAvailability 値に基づいて結果を説明するメッセージを返すメソッドを示しています。

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;
}

注釈

CheckAvailabilityAsync メソッドを使用して、現在のコンピューターで指紋認証がサポートされているかどうかを判断できます。

適用対象

こちらもご覧ください