Compartir a través de

Método IMbnInterfaceEvents::OnSetPreferredProvidersComplete (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.

El servicio de banda ancha móvil llama a este método de notificación para indicar la finalización de una operación SetPreferredProviders .

Sintaxis

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

Parámetros

[in] newInterface

IMbnInterface que representa un dispositivo en el que se realizó esta operación.

[in] requestID

Identificador de solicitud asignado por el servicio de banda ancha móvil para esta operación asincrónica.

[in] status

Estado de finalización de la operación.

En la tabla siguiente se enumeran los valores válidos para este estado.

Valor Significado
S_OK
 La operación se realizó correctamente.
E_MBN_PIN_REQUIRED
 El dispositivo requiere que se escriba un PIN para que esta operación se complete.
E_MBN_SIM_NOT_INSERTED
 La SIM no se inserta.
E_MBN_BAD_SIM
 Se inserta una SIM incorrecta en el dispositivo.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 El dispositivo no admite esta operación.

Valor devuelto

Este método debe devolver S_OK.

Comentarios

Si la operación se completó correctamente, es decir, cuando el estado es S_OK, la aplicación puede llamar al método GetPreferredProviders del IMbnInterface pasado para obtener una lista actualizada de proveedores preferidos.

Si hay varias aplicaciones registradas para notificaciones, se llamará a este método en todas las aplicaciones registradas. Esto significa que una aplicación que no inició la operación de actualización también recibirá una notificación.

Si una llamada al método SetPreferredProviders de IMbnInterface da como resultado un cambio en la lista de proveedores preferidos, no se llamará al método OnPreferredProvidersChange de IMbnInterfaceEvents .

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

IMbnInterfaceEvents