Свойство Sys.Services AuthenticationService defaultFailedCallback

Получает или задает имя функции обратного вызова, используемой по умолчанию в случае, когда выполнение исходного запроса завершается ошибкой.

ПримечаниеПримечание

Чтобы получить или задать значения свойств для клиентского прикладного программного интерфейса (API), необходимо вызвать методы доступа к свойствам, имена которых содержат префиксы get_ и set_. Например, чтобы получить или задать значение свойства, такого как cancel, следует вызвать метод get_cancel или set_cancel соответственно.

Sys.Services.AuthenticationService.set_defaultFailedCallback(value); 
var failedCallback =
  Sys.Services.AuthenticationService.get_ defaultFailedCallback();

Параметр

Описание

value

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

Функция, назначенная свойству defaultFailedCallback, используется по умолчанию в качестве функции обратного вызова в случае возникновения ошибок. Функцию, используемую по умолчанию в качестве обратного вызова, можно переопределить, передав имя другой функции методу logout или login.

При реализации функции обратного вызова необходимо использовать следующую сигнатуру:

function AuthenticationFailure(error, userContext, methodName)

Параметры, передаваемые функции обратного вызова, имеют следующие значения:

  • error. Содержит сведения об ошибке.

  • userContext. Информация о контексте пользователя, передаваемая методу logout или login.

  • methodName. Имя вызывающего метода.

Функция обратного вызова вызывается асинхронно, если пользователь не проходит проверку подлинности.

В следующем примере демонстрируется использование свойства defaultFailedCallback. Данный пример кода является частью полного примера, приведенного в описании класса Класс Sys.Services.AuthenticationService.


// This function sets and gets the default
// failed callback function.
function SetDefaultFailedCallBack()
{
    // Set the default callback function.
    Sys.Services.AuthenticationService.set_defaultFailedCallback(OnFailed);

    // Get the default callback function.
    var callBack =     
        Sys.Services.AuthenticationService.get_defaultFailedCallback();  
}


Показ: