Metodo IMbnRadio::SetSoftwareRadioState (mbnapi.h)

Articolo
02/28/2024

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Imposta lo stato della radio software di un dispositivo Mobile Broadband.

Sintassi

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

Parametri

[in] radioState

Valore MBN_RADIO che specifica il nuovo stato di radio software.

[out] requestID

Puntatore a un ID richiesta assegnato dal servizio Mobile Broadband per identificare questa richiesta.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	L'operazione è stata completata.
E_HANDLE	L'interfaccia non è valida. Probabilmente, il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L'interfaccia non è valida. Probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.

Commenti

SetSoftwareRadioState modifica lo stato della radio software del dispositivo. Si tratta di un'operazione asincrona e restituirà immediatamente. Al termine, il servizio Mobile Broadband chiamerà il metodo OnSetSoftwareRadioStateComplete dell'interfaccia IMbnRadioEvents .

La disabilitazione della radio per un dispositivo Mobile Broadband comporta la disattivazione di qualsiasi connessione attiva, disconnessione del pacchetto di rete e registrazione della rete. Se l'operazione di disattivazione della radio comporta una modifica dello stato della connessione, dello stato del collegamento di pacchetti o dello stato di registrazione di rete, l'applicazione riceverà una notifica delle modifiche.

Quando sia il software che la radio hardware sono abilitati per un dispositivo Mobile Broadband, tenterà automaticamente di registrarsi alla rete. Alcuni dispositivi possono anche provare a eseguire un pacchetto collegato alla rete. Ogni volta che lo stato cambia, l'applicazione chiamante riceverà notifiche di evento per la registrazione di rete e le modifiche dello stato di collegamento dei pacchetti.

Lo stato di radio di un dispositivo può cambiare senza una richiesta di modifica dall'applicazione. Ad esempio, se un utente attiva il commutatore hardware del sistema. Il servizio Mobile Broadband notifica all'applicazione di una modifica dello stato radio chiamando il metodo OnRadioStateChange dell'interfaccia IMbnRadioEvents .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnRadio

Condividi tramite