VpnChannel.RequestCredentials Methode

Referenz

Definition

Namespace:: Windows.Networking.Vpn

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Fordern Sie die VPN-Plattform an, um Anmeldeinformationen vom Benutzer zu sammeln. Das Plug-In kann den Typ und die Form der zu sammelnden Anmeldeinformationen angeben. Das Ergebnis ist ein Objekt, das die Hauptanmeldeinformationen enthält, abhängig vom Typ und den sekundären Anmeldeinformationen für Änderungs- und Ablauffälle.

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

Parameter

credType: VpnCredentialType

Ein Enumerationswert, der den Typ der zu sammelnden Anmeldeinformationen angibt.

isRetry: Boolean
bool

Wenn es sich bei der Anforderung um einen Wiederholungsversuch als vorheriger fehlgeschlagener Versuch handelt, ist sie WAHR; andernfalls ist es FALSE.

isSingleSignOnCredential: Boolean
bool

Wenn die Anmeldeinformationen von allen Anwendungen verwendet werden sollen, die über den VPN-Tunnel ausgeführt werden und sich für Ressourcen auf dem VPN authentifizieren, ist dies WAHR; andernfalls ist es FALSE. Dies bietet eine Einmalige Anmeldung über das VPN.

certificate: Certificate

Das Zertifikat, das optional übergeben werden kann, um die Plattform auf ihre Absicht hinzuweisen, die Zustimmung zu erhalten und den Schutz zu entsperren.

Gibt zurück

VpnPickedCredential

Ein Objekt, das die Hauptanmeldeinformationen und alle anderen Übergangsanmeldeinformationen enthält, die vom Benutzer ausgefüllt wurden.

Windows-Anforderungen

App-Funktionen

networkingVpnProvider

Hinweise

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK, andernfalls gibt die Funktion einen HRESULT-Fehlerwert zurück, der den spezifischen Fehler beschreibt. Wenn das Plug-In nicht verbunden ist, wird der Fehler E_ACCESSDENIED. Wenn kein arbeitsspeicher mehr verfügbar ist, wird der Fehler E_OUTOFMEMORY.

Anmerkung

Jeder Aufruf dieser API außerhalb eines verbundenen VPN-Plug-Ins schlägt fehl, da Aktivitäten und Interaktionen zwischen dem VPN-Plug-In und dem System vom VPN-Profil gesteuert werden.

Gilt für:

Freigeben über