Метод IMbnRegistration::SetRegisterMode (mbnapi.h)

Важно!

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

Задает режим регистрации для устройства.

Синтаксис

HRESULT SetRegisterMode(
  [in]  MBN_REGISTER_MODE registerMode,
  [in]  LPCWSTR           providerID,
  [in]  ULONG             dataClass,
  [out] ULONG             *requestID
);

Параметры

[in] registerMode

Значение MBN_REGISTER_MODE , указывающее новый режим регистрации.

[in] providerID

Строка, указывающая идентификатор поставщика сетевого поставщика, для которого требуется зарегистрировать. При MBN_REGISTER_MODE_AUTOMATICпараметр registerMode должен иметь значение NULL.

[in] dataClass

Побитовая комбинация значений OR MBN_DATA_CLASS , определяющих предпочтительную технологию доступа к данным для подключения. Служба мобильной широкополосной связи зарегистрирует самую высокую доступную технологию класса данных из этого списка. Если не удается зарегистрировать класс данных из этого списка, служба мобильной широкополосной связи зарегистрируется в лучшем доступном классе данных.

[out] requestID

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

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

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

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

Комментарии

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

Поддержка режима ручной регистрации необязательна, и приложение должно проверить, поддерживает ли устройство ручную регистрацию, проверив MBN_CTRL_CAPS_REG_MANUAL в параметре interfaceCaps , заполненном методом GetInterfaceCapabilityдля IMbnInterface. Если приложение устанавливает режим регистрации вручную, но устройство не поддерживает его, этот вызов вернет HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED).

SetRegisterMode является асинхронным и возвращается немедленно. Если ошибка отсутствует, по завершении операции служба мобильной широкополосной связи вызовет метод OnSetRegisterModeCompleteобъекта IMbnRegistrationEvents.

Требования

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

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

IMbnRegistration