Metodo IMbnInterface::GetVisibleProviders (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'elenco dei provider visibili.
Sintassi
HRESULT GetVisibleProviders(
[out, retval] ULONG *age,
[out, retval] SAFEARRAY **visibleProviders
);
Parametri
[out, retval] age
Puntatore al tempo in secondi dall'ultimo aggiornamento dell'elenco dei provider visibili dal dispositivo.
[out, retval] visibleProviders
Puntatore a una matrice di strutture MBN_PROVIDER che contiene l'elenco di provider per l'interfaccia. Se questo metodo restituisce un valore diverso da S_OK, questo parametro è NULL. In caso contrario, al termine, il programma chiamante deve liberare la memoria allocata chiamando SafeArrayDestroy.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. visibleProviders contiene valori validi. In base all'età delle informazioni, l'applicazione chiamante può decidere di emettere una nuova chiamata a ScanNetwork. |
|
Le informazioni non sono disponibili. È in corso un'analisi di rete attiva. L'applicazione chiamante può ricevere una notifica quando le funzionalità del dispositivo sono disponibili registrando per il metodo OnScanNetworkComplete di IMbnInterfaceEvents. |
|
La cache della banda larga mobile dell'elenco di rete visibile non è valida. L'applicazione chiamante deve chiamare ScanNetwork per popolare la cache. |
Commenti
Questo metodo restituisce l'elenco dei provider attualmente visibili. I dispositivi CDMA segnalano solo il provider di casa se è disponibile una rete nell'elenco di roaming preferito (PRL).
Per evitare frequenti operazioni di analisi di rete, il sistema operativo mantiene un elenco di operazioni di analisi recenti e l'elenco dei provider viene restituito dall'elenco memorizzato nella cache.
Un'applicazione può chiamare questo metodo per ottenere un elenco di provider visibili al completamento di ScanNetwork.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |