Metodo IMbnInterface::SetPreferredProviders (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.
Aggiornamenti l'elenco dei provider preferiti per il dispositivo.
Sintassi
HRESULT SetPreferredProviders(
[in] SAFEARRAY *preferredProviders,
[out] ULONG *requestID
);
Parametri
[in] preferredProviders
Matrice di strutture MBN_PROVIDER che contiene l'elenco di provider preferiti.
[out] requestID
Puntatore all'ID richiesta impostato dal sistema operativo per questa richiesta. La risposta asincrona conterrà lo stesso ID richiesta.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Il servizio Mobile Broadband non è in esecuzione in questo sistema. |
|
L'interfaccia non è valida, probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema. |
|
L'interfaccia non è valida. Probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema. |
Commenti
Il metodo SetPreferredProviders avvia un aggiornamento dell'elenco di provider preferito per l'interfaccia. Si tratta di un'operazione asincrona e la chiamata al metodo restituisce immediatamente. Se questo metodo restituisce correttamente (con S_OK), il sistema operativo notifica all'applicazione chiamante lo stato di completamento di questa operazione chiamando il metodo OnSetPreferredProvidersComplete di IMbnInterfaceEvents.
Se il dispositivo viene rimosso dal sistema prima del completamento dell'operazione, non vi è alcuna garanzia che la notifica di completamento verrà ricevuta dall'applicazione chiamante.
Requisiti
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |