VpnChannel.RequestCredentials Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Minta platform VPN untuk mengumpulkan kredensial dari pengguna. Plug-in dapat menentukan jenis dan bentuk kredensial yang akan dikumpulkan. Hasilnya adalah objek yang berisi kredensial utama tergantung pada jenis dan kredensial sekunder untuk kasus perubahan dan kedaluwarsa.
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
Nilai enum yang menunjukkan jenis kredensial yang akan dikumpulkan.
- isRetry
-
Boolean
bool
Jika permintaan adalah coba lagi dari upaya yang gagal sebelumnya, permintaan tersebut TRUE; jika tidak, ini adalah FALSE.
- isSingleSignOnCredential
-
Boolean
bool
Jika kredensial harus digunakan oleh semua aplikasi yang beroperasi melalui terowongan VPN dan mengautentikasi ke sumber daya di VPN, itu BENAR; jika tidak, ini adalah FALSE. Ini memberikan pengalaman akses menyeluruh melalui VPN.
- certificate
- Certificate
Sertifikat yang dapat diteruskan secara opsional untuk menunjukkan niat penggunaan platform dan mendapatkan persetujuan dan membuka kunci perlindungannya.
Mengembalikan
Objek yang berisi kredensial utama dan kredensial transisi lainnya yang diisi oleh pengguna.
Persyaratan Windows
Kemampuan aplikasi |
networkingVpnProvider
|
Keterangan
Jika fungsi berhasil, nilai pengembalian S_OK, jika tidak, fungsi akan mengembalikan nilai HRESULT kesalahan yang menjelaskan kegagalan tertentu. Jika plug-in tidak tersambung, kesalahannya E_ACCESSDENIED. Jika tidak ada lagi memori yang tersedia, kesalahannya E_OUTOFMEMORY.
Nota
Setiap panggilan ke API ini di luar plug-in VPN yang terhubung akan gagal, karena aktivitas dan interaksi antara plug-in VPN dan sistem dikendalikan oleh profil VPN.