Metodo IMbnConnection::GetConnectionState (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 lo stato di connessione corrente del dispositivo.
Sintassi
HRESULT GetConnectionState(
[out, retval] MBN_ACTIVATION_STATE *ConnectionState,
[out, retval] BSTR *ProfileName
);
Parametri
[out, retval] ConnectionState
Puntatore a una struttura MBN_ACTIVATION_STATE che contiene lo stato della connessione.
[out, retval] ProfileName
Puntatore a una stringa contenente il nome del profilo di connessione. Questo parametro è valido solo quando ConnectionState è MBN_ACTIVATION_STATE_ACTIVATED. Quando questa stringa non è NULL, l'applicazione chiamante deve liberare questa stringa chiamando SysFreeString.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente.
Nota Questo metodo può restituire S_OK quando ProfileName è NULL. Assicurarsi che il client sia in grado di gestire un nome ProfileNameNULL anche se la chiamata ha esito positivo.
|
|
Stato di attivazione non disponibile. Il servizio Mobile Broadband sta verificando il dispositivo per le informazioni. L'applicazione chiamante può ricevere una notifica quando lo stato di attivazione è disponibile registrando per il metodo OnConnectStateChange di IMbnConnectionEvents. |
|
È necessario un PIN per ottenere lo stato della chiamata. |
|
Una SIM non viene inserita nel dispositivo. |
|
Una SIM non valida viene inserita nel dispositivo. |
Commenti
Questo metodo può restituire S_OK quando ProfileName è NULL. Assicurarsi che il client sia in grado di gestire un nome ProfileNameNULL anche se la chiamata ha esito positivo.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |