Metodo IMbnRegistration::GetAvailableDataClasses (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 le classi di dati disponibili nella rete corrente.
Sintassi
HRESULT GetAvailableDataClasses(
[out] ULONG *availableDataClasses
);
Parametri
[out] availableDataClasses
Puntatore a una combinazione OR bit per bit di valori 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. |
Commenti
GetAvailableDataClasses restituisce il set di classi di dati possibili nella rete corrente. Questi valori possono essere impostati su MBN_DATA_CLASS_NONE se il valore non è noto.
Le classi di dati disponibili possono cambiare automaticamente quando un dispositivo passa da una cella 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 |