VpnChannel.RequestCredentials 方法

定义

命名空间:

Windows.Networking.Vpn

请求 VPN 平台从用户那里收集凭据。 插件可以指定要收集的凭据的类型和形式。 结果是一个对象，其中包含主要凭据，具体取决于更改和过期情况的类型和辅助凭据。

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

参数

credType

VpnCredentialType

一个枚举值，指示要收集的凭据类型。

isRetry

Boolean

bool

如果请求是前一次失败尝试的重试，则为 TRUE;否则为 FALSE。

isSingleSignOnCredential

Boolean

bool

如果凭据应由通过 VPN 隧道运行的所有应用程序使用，并向 VPN 上的资源进行身份验证，则为 TRUE;否则为 FALSE。 这通过 VPN 提供单一登录体验。

certificate

Certificate

可以选择传递的证书，以指示平台其使用意图并获取同意并解锁其保护。

返回

VpnPickedCredential

一个对象，其中包含主凭据和用户填写的任何其他过渡凭据。

Windows 要求

应用功能	networkingVpnProvider

注解

如果函数成功，则返回值 S_OK，否则该函数将返回描述特定失败的错误 HRESULT 值。 如果插件未连接，则错误 E_ACCESSDENIED。 如果没有更多可用内存，则错误 E_OUTOFMEMORY。

注意

在连接的 VPN 插件外部调用此 API 将失败，因为 VPN 插件与系统之间的活动和交互由 VPN 配置文件控制。