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

Метод IMbnPinManagerEvents::OnGetPinStateComplete (mbnapi.h)

  • Статья

Важно!

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

Метод уведомления, вызываемый службой мобильной широкополосной связи для указания завершения асинхронной операции, активируется вызовом метода GetPinStateобъекта IMbnPinManager.

Синтаксис

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Параметры

[in] pinManager

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

[in] pinInfo

Структура MBN_PIN_INFO , содержащая сведения о ПИН-коде устройства.

Если для pinInfo.pinState задано значение MBN_PIN_STATE_NONE то устройство не должно вводить ПИН-код.

Если параметр pinInfo.pinState имеет значение MBN_PIN_STATE_ENTER устройство ожидает ввода ПИН-кода, а pinInfo.pinType представляет тип ПИН-кода, ожидаемый устройством.

Если для параметра pinInfo.pinState задано значение MBN_PIN_STATE_UNBLOCK устройство блокирует ПИН-код и следует предпринять попытку разблокировки устройства. В этом случае pinInfo.pinType представляет тип ПИН-кода, для которого должна выполняться операция разблокировки.

Если параметр pinInfo.pinState имеет значение MBN_PIN_STATE_ENTER или MBN_PIN_STATE_UNBLOCK, то параметр pinInfo.attemptsRemaining содержит количество оставшихся попыток ввода допустимого ПИН-кода или ключа разблокировки ПИН-кода (PUK). Если число оставшихся попыток неизвестно, то параметру pinInfo.attemptsRemaining присваивается значение MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

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

[in] status

Состояние завершения операции.

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

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

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

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

Комментарии

Этот метод вызывается службой мобильной широкополосной связи для уведомления приложения о завершении асинхронной операции, запущенной вызовом метода GetPinStateобъекта IMbnPinManager.
После успешного завершения pinInfo содержит сведения о ПИН-коде, который будет ожидать устройство.

Требования

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

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

События IMbnPinManagerEvents