ConnectionProfile.IsDomainAuthenticatedBy(DomainAuthenticationKind) Metode

Definisi

Ruang nama:

Windows.Networking.Connectivity

Kueri apakah metode autentikasi domain yang ditentukan berhasil untuk profil koneksi ini.

public:
 virtual bool IsDomainAuthenticatedBy(DomainAuthenticationKind kind) = IsDomainAuthenticatedBy;

bool IsDomainAuthenticatedBy(DomainAuthenticationKind const& kind);

public bool IsDomainAuthenticatedBy(DomainAuthenticationKind kind);

function isDomainAuthenticatedBy(kind)

Public Function IsDomainAuthenticatedBy (kind As DomainAuthenticationKind) As Boolean

Parameter

kind

DomainAuthenticationKind

Metode autentikasi domain tertentu untuk dikueri.

Mengembalikan

Boolean

bool

true jika profil koneksi ini memiliki jenis autentikasi domain yang sama seperti yang ditentukan dalam parameter jenis ; false jika profil koneksi ini memiliki jenis autentikasi domain yang berbeda dari yang ditentukan dalam jenis.

Persyaratan Windows

Rangkaian perangkat	Windows 11 Insider Preview (diperkenalkan dalam 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v15.0)

Contoh

Skenario untuk contoh kode ini adalah bahwa alat diagnostik jaringan untuk admin TI ingin memastikan bahwa koneksi ke jaringan perusahaan memiliki properti autentikasi yang benar.

using Windows.Networking.Connectivity;

...

public class Diagnostics
{
    private async void LogToConsole(string output, string connectionProfileName)
    {
        // Implementation omitted for brevity.
    }

    public async void RunDiagnostics()
    {
        // Retrieve the ConnectionProfile.
        ConnectionProfile internetConnectionProfile =
            NetworkInformation.GetInternetConnectionProfile();
        if (internetConnectionProfile == null)
        {
            LogToConsole("Device isn't connected to a network", "");
            return;
        }

        string connectionProfileName =
            internetConnectionProfile.ProfileName;
        bool isDomainAuthenticated =
            !internetConnectionProfile.IsDomainAuthenticatedBy(DomainAuthenticationKind.None);
        bool isLdapAuthenticated =
            internetConnectionProfile.IsDomainAuthenticatedBy(DomainAuthenticationKind.Ldap);
        bool isTlsAuthenticated =
            internetConnectionProfile.IsDomainAuthenticatedBy(DomainAuthenticationKind.Tls);

        if (isDomainAuthenticated)
        {
            if (isLdapAuthenticated)
            {
                LogToConsole("Connection profile is domain-authenticated via LDAP",
                    connectionProfileName);
            }
            if (isTlsAuthenticated)
            {
                LogToConsole("Connection profile is domain-authenticated via TLS",
                    connectionProfileName);
            }

            if (!isLdapAuthenticated && !isTlsAuthenticated)
            {
                LogToConsole("Connection profile wasn't expected to be domain authenticated for any other kinds",
                    connectionProfileName);
            }
        }
        else
        {
            LogToConsole("Connection profile isn't domain-authenticated",
                connectionProfileName);
        }
    }
}