Metodo IMbnRegistration::GetProviderName (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 nome del provider per la rete attualmente registrata.
Sintassi
HRESULT GetProviderName(
[out] BSTR *providerName
);
Parametri
[out] providerName
Puntatore a una stringa contenente il nome del provider attualmente registrato. La lunghezza massima di questa stringa è MBN_PROVIDERNAME_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 nome del provider non è disponibile. Il servizio Mobile Broadband sta attualmente eseguendo il probe del dispositivo per le informazioni. Quando il nome del provider è disponibile, il servizio Mobile Broadband chiamerà il metodo OnRegisterModeAvailable di IMbnRegistrationEvents. |
|
Per ottenere il nome del provider è necessario un PIN. |
|
Una SIM non viene inserita nel dispositivo. |
|
Nel dispositivo viene inserita una SIM non valida. |
Commenti
Il nome del provider può cambiare quando il dispositivo Mobile Broadband passa da una rete a un'altra. Ciò include ogni volta che si passa 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 modifica 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 ripristinabile 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). 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 |