Compartir a través de

Método IMbnInterface::SetPreferredProviders (mbnapi.h)

  • Artículo

Importante

A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.

Novedades la lista de proveedores preferidos para el dispositivo.

Sintaxis

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

Parámetros

[in] preferredProviders

Matriz de estructuras de MBN_PROVIDER que contiene la lista de proveedores preferidos.

[out] requestID

Puntero al identificador de solicitud establecido por el sistema operativo para esta solicitud. La respuesta asincrónica contendrá este mismo requestID.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 El servicio de banda ancha móvil no se está ejecutando en este sistema.
E_HANDLE
 La interfaz no es válida, lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.

Comentarios

El método SetPreferredProviders inicia una actualización de la lista de proveedores preferida para la interfaz. Se trata de una operación asincrónica y la llamada al método devuelve inmediatamente. Si este método devuelve correctamente (con S_OK), el sistema operativo notificará a la aplicación que realiza la llamada sobre el estado de finalización de esta operación llamando al método OnSetPreferredProvidersComplete de IMbnInterfaceEvents.

Si el dispositivo se quita del sistema antes de que se complete esta operación, no hay ninguna garantía de que la aplicación que realiza la llamada recibirá la notificación de finalización.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mbnapi.h

Consulte también

IMbnInterface