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

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

  • Статья

Важно!

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

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

Синтаксис

HRESULT OnUnblockComplete(
  [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-карта.

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

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

Комментарии

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

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

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

Если устройство не разблокировано, а блокировка PUK связана с MBN_PIN_TYPE_PIN1 закреплением, это также приведет к изменению состояния готовности устройства на MBN_READY_STATE_BAD_SIM. Вызывающее приложение будет получать уведомления об изменении ReadyState через элемент OnReadyStateChangeобъекта IMbnInterfaceEvents.

Требования

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

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

IMbnPinEvents