Metodo IMbnRegistration::GetCurrentDataClass (mbnapi.h)
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.
Ottiene la classe di dati corrente nella rete corrente.
Sintassi
HRESULT GetCurrentDataClass(
[out] ULONG *currentDataClass
);
Parametri
[out] currentDataClass
Puntatore a un valore MBN_DATA_CLASS . Questo parametro è significativo solo se la funzione restituisce S_OK.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Le classi di dati non sono disponibili. Il servizio Mobile Broadband sta attualmente eseguendo il probe del dispositivo per le informazioni. Quando le classi di dati sono disponibili, il servizio Mobile Broadband chiamerà il metodo OnPacketServiceStateChange di IMbnRegistrationEvents. |
|
Per ottenere le classi di dati è necessario un PIN. |
|
Una SIM non viene inserita nel dispositivo. |
|
Nel dispositivo viene inserita una SIM non valida. |
Commenti
Il metodo GetCurrentDataClass restituisce la classe di dati nella rete corrente. Questo valore può essere impostato su MBN_DATA_CLASS_NONE se il valore non è noto.
La classe di dati corrente può cambiare automaticamente quando un dispositivo passa da una rete cellulare a un'altra. Ogni volta che si verifica una modifica di questo tipo, il servizio Mobile Broadband invia una notifica alle applicazioni chiamando il metodo OnPacketServiceStateChange di IMbnRegistrationEvents.
Per l'errore ripristinabile E_MBN_PIN_REQUIRED, il servizio Mobile Broadband tenterà nuovamente di recuperare queste informazioni dal dispositivo quando la condizione di errore è finita (quando viene immesso un PIN). Successivamente, il servizio Mobile Broadband chiamerà il metodo OnPacketServiceStateChange di IMbnRegistrationEvents.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |