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

Метод IMbnPinEvents::OnDisableComplete (mbnapi.h)

  • Статья

Важно!

Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.

Метод уведомления, вызываемый службой мобильной широкополосной связи, чтобы указать, что операция отключения ПИН-кода завершена.

Синтаксис

HRESULT OnDisableComplete(
  [in] IMbnPin      *pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Параметры

[in] pin

Интерфейс IMbnPin , тип ПИН-кода.

[in] pinInfo

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

[in] requestID

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

[in] status

Код состояния, указывающий результат операции.

Вызывающее приложение может ожидать одно из следующих значений.

Значение Значение
S_OK
 Операция выполнена успешно.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Устройство не поддерживает эту операцию.
E_FAIL
 Не удалось завершить операцию.
E_MBN_PIN_REQUIRED
 Для завершения операции требуется ПИН-код. Вызывающее приложение может вызвать метод GetPinStateIMbnPinManager , чтобы обнаружить тип ожидаемого ПИН-кода.
E_MBN_SIM_NOT_INSERTED
 На устройстве нет SIM-карты.
E_MBN_BAD_SIM
 На устройстве есть неправильная SIM-карта.
E_MBN_FAILURE
 Не удалось использовать ПИН-код.

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

Этот метод должен возвращать S_OK.

Комментарии

Метод OnDisableComplete вызывается службой мобильной широкополосной связи, чтобы сообщить о состоянии завершения операции отключения ПИН-кода, инициализированной вызовом метода DisableIMbnPin.

Содержимое pinInfo имеет смысл только в том случае, если состояниеE_MBN_FAILURE. Элемент pinState следует игнорировать, а для поля pinType задан тип ПИН-кода текущего интерфейса IMbnPin . Эта структура содержит оставшиеся попытки ввода допустимого ПИН-кода.

Например, если ПИН-код, переданный для изменения типа ПИН-кода, является неверным, операция завершится ошибкой с кодом состояния E_MBN_FAILURE. В этом случае pinInfo.attemptsRemaining указывает количество оставшихся попыток повторить эту операцию. Если повторные попытки с неправильным ПИН-кодом приводят к тому, что попыткаremaining становится 0, приложение может вызвать метод GetPinStateIMbnPinManager , чтобы получить требуемый тип ПИН-кода.

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mbnapi.h

См. также раздел

События IMbnPinEvents