Metodo IMbnRegistration::GetRoamingText (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 il testo mobile che descrive il provider di roaming.
Sintassi
HRESULT GetRoamingText(
[out] BSTR *roamingText
);
Parametri
[out] roamingText
Puntatore a una stringa che contiene informazioni aggiuntive su una rete con cui il dispositivo è in roaming. La lunghezza massima è MBN_ROAMTEXT_LEN caratteri. La stringa viene compilata solo quando il metodo restituisce S_OK per l'esito positivo. Al termine, l'applicazione chiamante deve liberare la memoria allocata chiamando SysFreeString.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Il testo mobile non è disponibile. Il servizio Mobile Broadband sta attualmente eseguendo il probe del dispositivo per le informazioni. Quando il testo mobile è disponibile, il servizio Mobile Broadband chiamerà il metodo OnRegisterModeAvailable di IMbnRegistrationEvents. |
|
È necessario un PIN per ottenere il testo mobile. |
|
Una SIM non viene inserita nel dispositivo. |
|
Nel dispositivo viene inserita una SIM non valida. |
Commenti
Il metodo GetRoamingText può ottenere una stringa di testo contenente informazioni aggiuntive sulla rete quando lo stato di registrazione è MBN_REGISTER_STATE_PARTNER o MBN_REGISTER_STATE_ROAMING.
Queste informazioni possono cambiare quando il dispositivo Mobile Broadband passa da una rete a un'altra. Ciò include ogni volta che viene apportata una modifica da MBN_REGISTER_STATE_HOME a MBN_REGISTER_STATE_SEARCHING nello stato di registrazione di rete. Ciò si verifica anche quando si verifica una modifica nella rete registrata, ad esempio quando una rete sposta la registrazione da un provider a un altro. Dopo queste modifiche, il servizio Mobile Broadband chiamerà il metodo OnRegisterStateChange 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). Chiamerà quindi il metodo OnRegisterStateChange di IMbnRegistrationEvents.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |