Поделиться через


VpnChannel.RequestCredentials Метод

Определение

Запросите у платформы VPN получение учетных данных у пользователя. Подключаемый модуль может указать тип и форму собираемых учетных данных. Результатом является объект, содержащий учетные данные main в зависимости от типа и дополнительных учетных данных для случаев изменения и истечения срока действия.

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

Сертификат, который можно передать при необходимости, чтобы указать платформу, которую она намерена использовать, получить согласие и разблокировать защиту.

Возвращаемое значение

Объект , содержащий учетные данные main и любые другие переходные учетные данные, заполненные пользователем.

Требования к Windows

Возможности приложения
networkingVpnProvider

Комментарии

Если функция выполняется успешно, возвращаемое значение S_OK, в противном случае функция вернет значение ошибки HRESULT, описывающее конкретный сбой. Если подключаемый модуль не подключен, ошибка E_ACCESSDENIED. Если доступной памяти больше нет, ошибка E_OUTOFMEMORY.

Примечание

Любой вызов этого API за пределами подключаемого подключаемого модуля VPN завершится ошибкой, так как действия и взаимодействие между подключаемым модулем VPN и системой управляются профилем VPN.

Применяется к