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 プラグインとシステム間のアクティビティと相互作用は VPN プロファイルによって制御されるため、接続された VPN プラグインの外部でこの API を呼び出すと失敗します。