Método IMbnRadio::SetSoftwareRadioState (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.

Establece el estado de radio de software de un dispositivo de banda ancha móvil.

Sintaxis

HRESULT SetSoftwareRadioState(
  [in]  MBN_RADIO radioState,
  [out] ULONG     *requestID
);

Parámetros

[in] radioState

Valor MBN_RADIO que especifica el nuevo estado de radio de software.

[out] requestID

Puntero a un identificador de solicitud asignado por el servicio de banda ancha móvil para identificar esta solicitud.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
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.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	El servicio de banda ancha móvil no se está ejecutando en este sistema.

Comentarios

SetSoftwareRadioState cambia el estado de radio del software del dispositivo. Se trata de una operación asincrónica y se devolverá inmediatamente. Al finalizar, el servicio de banda ancha móvil llamará al método OnSetSoftwareRadioStateComplete de la interfaz IMbnRadioEvents .

Deshabilitar la radio de un dispositivo de banda ancha móvil provocará la desactivación de cualquier conexión activa, desasociación de paquetes de red y registro de red. Si la operación de desactivación de radio da como resultado un cambio en el estado de conexión, el estado de conexión de paquetes o el estado de registro de red, la aplicación recibirá una notificación de los cambios.

Cuando el software y la radio de hardware están habilitados para un dispositivo de banda ancha móvil, intentará registrarse automáticamente en la red. Además, algunos dispositivos también pueden intentar realizar una conexión de paquetes a la red. Cada vez que cambie el estado, la aplicación que realiza la llamada recibirá notificaciones de eventos para el registro de red y los cambios de estado de conexión de paquetes.

El estado de radio de un dispositivo puede cambiar sin una solicitud de cambio de la aplicación. Por ejemplo, si un usuario activa el conmutador de radio de hardware del sistema. El servicio de banda ancha móvil notificará a la aplicación sobre un cambio en el estado de radio llamando al método OnRadioStateChange de la interfaz IMbnRadioEvents .

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

IMbnRadio