ConnectionProfile.IsDomainAuthenticatedBy(DomainAuthenticationKind) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
O método de autenticação de domínio específico sobre o qual consultar.
Retornos
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);
}
}
}