VpnChannel.RequestCredentials Método

Definição

Namespace:

Windows.Networking.Vpn

Solicite à plataforma VPN para coletar credenciais do usuário. O plug-in pode especificar o tipo e a forma de credenciais a serem coletadas. O resultado é um objeto que contém as credenciais principais, dependendo do tipo e das credenciais secundárias para casos de alteração e expiração.

public:
 virtual VpnPickedCredential ^ RequestCredentials(VpnCredentialType credType, bool isRetry, bool isSingleSignOnCredential, Certificate ^ certificate) = RequestCredentials;

VpnPickedCredential RequestCredentials(VpnCredentialType const& credType, bool const& isRetry, bool const& isSingleSignOnCredential, Certificate const& certificate);

public VpnPickedCredential RequestCredentials(VpnCredentialType credType, bool isRetry, bool isSingleSignOnCredential, Certificate certificate);

function requestCredentials(credType, isRetry, isSingleSignOnCredential, certificate)

Public Function RequestCredentials (credType As VpnCredentialType, isRetry As Boolean, isSingleSignOnCredential As Boolean, certificate As Certificate) As VpnPickedCredential

Parâmetros

credType

VpnCredentialType

Um valor de enumeração que indica o tipo de credencial a ser coletada.

isRetry

Boolean

bool

Se a solicitação for uma repetição da tentativa com falha anterior, ela será TRUE; caso contrário, será FALSE.

isSingleSignOnCredential

Boolean

bool

Se a credencial deve ser usada por todos os aplicativos que operam pelo túnel VPN e autenticação para recursos na VPN, ela é TRUE; caso contrário, será FALSE. Isso fornece uma única experiência de logon pela VPN.

certificate

Certificate

O certificado que pode ser passado opcionalmente para indicar à plataforma sua intenção de usar e obter consentimento e desbloquear sua proteção.

Retornos

VpnPickedCredential

Um objeto que contém as credenciais principais e quaisquer outras credenciais de transição preenchidas pelo usuário.

Requisitos do Windows

Funcionalidades do aplicativo

networkingVpnProvider

Comentários

Se a função for bem-sucedida, o valor retornado será S_OK, caso contrário, a função retornará um valor HRESULT de erro que descreve a falha específica. Se o plug-in não estiver conectado, o erro será E_ACCESSDENIED. Se não houver mais memória disponível, o erro será E_OUTOFMEMORY.

Nota

Qualquer chamada para essa API fora de um plug-in VPN conectado falhará, pois a atividade e as interações entre o plug-in VPN e o sistema são controladas pelo perfil VPN.