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

Метод IMbnPin::Unblock (mbnapi.h)

  • Статья

Важно!

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

Разблокирует заблокированный ПИН-код.

Синтаксис

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Параметры

[in] puk

Значение ключа разблокировки пароля (PUK) для этого типа ПИН-кода.

[in] newPin

Новый ПИН-код, который необходимо задать для этого типа ПИН-кода.

[out] requestID

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

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод завершился успешно.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Служба мобильного широкополосного подключения не работает в этой системе.
E_HANDLE
 Недопустимый интерфейс. Мобильное широкополосное устройство, вероятно, было удалено из системы.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Недопустимый интерфейс. Скорее всего, мобильное широкополосное устройство было удалено из системы.
E_ACCESSDENIED
 Этот метод не допускается для вызова привилегий процесса.

Комментарии

Метод Unblock разблокирует ПИН-код для типа закрепления путем ввода PUK и задает новый ПИН-код. Свойство PinType этого IMbnPin представляет тип ПИН-кода, который изменяется.

Это асинхронная операция. Если метод возвращается с успехом, то по завершении операции служба мобильного широкополосного подключения вызовет метод OnUnblockCompleteобъекта IMbnPinEvents.

Всякий раз, когда метод GetPinStateIMbnPinManager дает результат с текущим состоянием ПИН-кода , равным MBN_PIN_STATE_UNBLOCK, приложение должно использовать разблокировку для типа ПИН-кода, возвращаемого в PinInfo.pinType , переданном методом OnGetPinStateCompleteобъекта IMbnPinManagerEvents.

Для вызова этого метода требуются права администратора.

Требования

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

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

IMbnPin