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

Метод IMbnPinManager::GetPinState (mbnapi.h)

  • Статья

Важно!

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

Возвращает текущее состояние ПИН-кода устройства.

Синтаксис

HRESULT GetPinState(
  [out] ULONG *requestID
);

Параметры

[out] requestID

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

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

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

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

Комментарии

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

Этот метод всегда возвращает текущее состояние ПИН-кода устройства. Он не кэшируется состояние ПИН-кода на момент создания этого объекта. Вместо этого он всегда обращается к устройству и возвращает текущее состояние ПИН-кода устройства.

Так как это асинхронная операция, GetPinState возвращается немедленно. После завершения операции служба мобильной широкополосной связи вызовет метод OnGetPinStateCompleteобъекта IMbnPinManagerEvents.

Всякий раз, когда операция возвращает E_MBN_PIN_REQUIRED или состояние готовности, сообщаемое устройством, MBN_READY_STATE_DEVICE_LOCKED, приложение должно использовать этот метод для запроса типа ПИН-кода, необходимого для разблокировки устройства или SIM-карты.

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

Требования

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

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

IMbnPinManager