Método IMbnServiceActivationEvents::OnActivationComplete (mbnapi.h)

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.

Método de notificación llamado por el servicio de banda ancha móvil para indicar que se completó una solicitud de activación del servicio.

Sintaxis

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

Parámetros

[in] serviceActivation

Puntero a una interfaz IMbnServiceActivation que representa el dispositivo en el que se realizó la solicitud.

[in] vendorSpecificData

Matriz de bytes que contiene los datos devueltos por el controlador de miniporte de banda ancha móvil subyacente en NDIS_STATUS_WWAN_SERVICE_ACTIVATION.

[in] requestID

Identificador de solicitud asignado por el servicio de banda ancha móvil cuando se inicializó la solicitud.

[in] status

Estado de finalización.

Una aplicación que llama puede esperar uno de los siguientes valores.

Valor	Significado
S_OK	La operación se realizó correctamente.
E_INVALIDARG	El controlador de minipuerto detectó datos de entrada incorrectos en la solicitud.
E_MBN_PIN_REQUIRED	Se requiere un PIN para que se complete la operación.
E_MBN_RADIO_POWER_OFF	El dispositivo de banda ancha móvil no está encendido.
E_MBN_PROVIDER_NOT_VISIBLE	El proveedor de servicios no está visible.
E_MBN_SIM_NOT_INSERTED	No hay ninguna SIM en el dispositivo.
E_MBN_BAD_SIM	Hay una TARJETA SIM incorrecta en el dispositivo.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	El dispositivo no admite esta operación.

[in] networkError

Código de error devuelto por la red durante la operación de activación. Este valor solo es significativo cuando el estado no es S_OK.

El valor exacto de networkError depende del controlador o de la red.

Valor devuelto

Este método debe devolver S_OK.

Comentarios

La activación correcta del servicio también dará como resultado un cambio en el estado listo del dispositivo. El servicio de banda ancha móvil llamará al método OnReadyStateChange de IMbnInterfaceEvents como notificación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mbnapi.h

Consulte también

IMbnServiceActivationEvents