VpnChannel.RequestCredentials Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запросите 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
Сертификат, который можно передать при необходимости, чтобы указать платформу, которую она намерена использовать, и получить согласие и разблокировать ее защиту.
Возвращаемое значение
Объект, содержащий основные учетные данные и любые другие переходные учетные данные, заполненные пользователем.
Требования к Windows
Возможности приложения |
networkingVpnProvider
|
Комментарии
Если функция выполнена успешно, возвращаемое значение S_OK, в противном случае функция вернет значение HRESULT, описывающее конкретный сбой. Если подключаемый модуль не подключен, ошибка E_ACCESSDENIED. Если доступно больше памяти, ошибка E_OUTOFMEMORY.
Заметка
Любой вызов этого API за пределами подключенного VPN-подключаемого модуля завершится ошибкой, так как действия и взаимодействия между подключаемым модулем VPN и системой управляются профилем VPN.