Метод IMbnInterface::SetPreferredProviders (mbnapi.h)

Важно!

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

Обновления список предпочтительных поставщиков для устройства.

Синтаксис

HRESULT SetPreferredProviders(
  [in]  SAFEARRAY *preferredProviders,
  [out] ULONG     *requestID
);

Параметры

[in] preferredProviders

Массив структур MBN_PROVIDER , содержащий список предпочтительных поставщиков.

[out] requestID

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

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

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

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

Комментарии

Метод SetPreferredProviders инициирует обновление списка предпочтительных поставщиков для интерфейса. Это асинхронная операция, и вызов метода возвращается немедленно. Если этот метод возвращает успешно (с S_OK), операционная система уведомит вызывающее приложение о состоянии завершения этой операции, вызвав метод OnSetPreferredProvidersCompleteобъекта IMbnInterfaceEvents.

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

Требования

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

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

IMbnInterface