ConnectionProfile.IsDomainAuthenticatedBy(DomainAuthenticationKind) Método

Definição

Namespace:

Windows.Networking.Connectivity

Consulta se o método de autenticação de domínio especificado foi bem-sucedido para esse perfil de conexão.

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

Parâmetros

kind

DomainAuthenticationKind

O método de autenticação de domínio específico sobre o qual consultar.

Retornos

Boolean

bool

true se esse perfil de conexão tiver o mesmo tipo de autenticação de domínio especificado no parâmetro de tipo ; false se esse perfil de conexão tiver um tipo de autenticação de domínio diferente daquele especificado em tipo.

Requisitos do Windows

Família de dispositivos	Windows 11 Insider Preview (introduzida na 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v15.0)

Exemplos

O cenário para este exemplo de código é que uma ferramenta de diagnóstico de rede para administradores de TI deseja garantir que as conexões com uma rede corporativa tenham as propriedades de autenticação corretas.

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