Метод IMbnRegistrationEvents::OnSetRegisterModeComplete (mbnapi.h)

Статья
08/24/2023

Важно!

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

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

Синтаксис

HRESULT OnSetRegisterModeComplete(
  [in] IMbnRegistration *newInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

Параметры

[in] newInterface

Указатель на интерфейс IMbnRegistration , представляющий соответствующее устройство. Приложение обработки может использовать этот интерфейс для получения текущего состояния регистрации устройства.

[in] requestID

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

[in] status

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

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

Значение	Значение
S_OK	Операция выполнена успешно.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Уже установлено активное сетевое подключение. Режим регистрации нельзя изменить при наличии уже установленного подключения к данным. Приложение должно сначала отключить подключение, а затем попытаться изменить режим регистрации. Если устройство уже находится в запрошенном режиме и подключено к запрашиваемой поставщику, код возврата будет S_OK.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Операция не поддерживается устройством. Это может быть возвращено устройствами, которые не поддерживают запрошенный режим регистрации. Например, устройство CDMA возвратит эту ошибку при запросе на переключение в режим регистрации вручную.
E_FAIL	Не удалось завершить операцию. Дополнительные сведения см. в статье Код сетевой ошибки.
E_INVALIDARG	Недопустимые входные данные в режиме регистрации или идентификатор поставщика, указанный в качестве входных данных, превышает максимальную длину 7 символов или указан недопустимый класс данных. Служба мобильной широкополосной связи не будет отправлять запрос на устройство, если во входных данных указаны недопустимые аргументы. В режиме регистрации вручную это означает, что запрошенный поставщик запрещен.
E_MBN_PIN_REQUIRED	Для завершения операции требуется ПИН-код.
E_MBN_SERVICE_NOT_ACTIVATED	Срок действия подписки на сетевую службу истек.
E_MBN_PROVIDER_NOT_VISIBLE	Это происходит только при переключении в режим регистрации вручную. Переключение выполнено успешно, но запрошенный поставщик не отображается. Устройство зарегистрируется у запрошенного поставщика, когда оно станет видимым.

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

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

Требования


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

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

События IMbnRegistrationEvents

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