VpnChannel.RequestCredentials Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Demandez à la plateforme VPN de collecter les informations d’identification de l’utilisateur. Le plug-in peut spécifier le type et la forme des informations d’identification à collecter. Le résultat est un objet contenant les informations d’identification principales en fonction du type et des informations d’identification secondaires pour les cas de modification et d’expiration.
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
Paramètres
- credType
- VpnCredentialType
Valeur d’énumération indiquant le type d’informations d’identification à collecter.
- isRetry
-
Boolean
bool
Si la requête est une nouvelle tentative à partir d’une tentative ayant échoué précédemment, elle a la valeur TRUE ; sinon, il est FAUX.
- isSingleSignOnCredential
-
Boolean
bool
Si les informations d’identification doivent être utilisées par toutes les applications qui fonctionnent sur le tunnel VPN et s’authentifient auprès des ressources sur le VPN, il est VRAI ; sinon, il est FAUX. Cela fournit une expérience d’authentification unique via le VPN.
- certificate
- Certificate
Certificat qui peut être transmis éventuellement pour indiquer à la plateforme son intention d’utilisation et obtenir le consentement et déverrouiller sa protection.
Retours
Objet contenant les informations d’identification principales et les autres informations d’identification transitionnelles remplies par l’utilisateur.
Configuration requise pour Windows
Fonctionnalités de l’application |
networkingVpnProvider
|
Remarques
Si la fonction réussit, la valeur de retour est S_OK; sinon, la fonction retourne une valeur HRESULT d’erreur décrivant l’échec spécifique. Si le plug-in n’est pas connecté, l’erreur est E_ACCESSDENIED. S’il n’y a plus de mémoire disponible, l’erreur est E_OUTOFMEMORY.
Note
Tout appel à cette API en dehors d’un plug-in VPN connecté échoue, car l’activité et les interactions entre le plug-in VPN et le système sont contrôlées par le profil VPN.