Metodo IMbnRegistration::GetProviderID (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 l'ID del provider per la rete attualmente registrata.
Sintassi
HRESULT GetProviderID(
[out] BSTR *providerID
);
Parametri
[out] providerID
Puntatore a una stringa contenente l'ID del provider attualmente registrato. La lunghezza massima è MBN_PROVIDERID_LEN caratteri. La stringa viene riempita solo quando il metodo restituisce S_OK per esito positivo. Al termine dell'operazione, 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. |
|
L'ID del provider non è disponibile. Il servizio Mobile Broadband sta attualmente verificando il dispositivo per le informazioni. Quando è disponibile l'ID provider, il servizio Mobile Broadband chiamerà il metodo OnRegisterModeAvailable di IMbnRegistrationEvents. |
|
È necessario un PIN per ottenere l'ID del provider. |
|
Una SIM non viene inserita nel dispositivo. |
|
Una SIM non valida viene inserita nel dispositivo. |
Commenti
Il metodo GetProviderID ottiene l'ID del provider attualmente registrato. Per la modalità di selezione automatica della rete, si tratta dell'ID della rete a cui è attualmente registrato il dispositivo. Se la modalità di selezione di rete è manuale, questo campo conterrà l'ID provider della rete a cui tenterà di registrare il dispositivo. Per i dispositivi CDMA è impostato su MBN_CDMA_DEFAULT_PROVIDER_ID se l'ID del provider non è noto.
Queste informazioni possono cambiare quando il dispositivo Mobile Broadband passa da una rete a un'altra. Ciò include ogni volta che si verifica una modifica da MBN_REGISTER_STATE_HOME a MBN_REGISTER_STATE_SEARCHING nello stato di registrazione della 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. In questo caso, l'applicazione deve chiamare GetProviderID.
Per l'errore recuperabile E_MBN_PIN_REQUIRED, il servizio Mobile Broadband tenterà 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
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |