Metodo IMbnInterface::ScanNetwork (mbnapi.h)

  • Articolo

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.

Analizza in modo asincrono la rete per ottenere un elenco di provider visibili.

Sintassi

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

Parametri

[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
S_OK
 Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE
 L'interfaccia non è valida. Probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 L'interfaccia non è valida. Probabilmente perché il dispositivo Mobile Broadband è stato rimosso dal sistema.

Commenti

Questo metodo avvia un'operazione di analisi di rete. Al termine, popola la cache del sistema operativo di provider e applicazioni visibili può chiamare il metodo GetVisibleProviders di IMbnInterface per ottenere un elenco di reti visibili.

Si tratta di un'operazione che richiede molto tempo. Pertanto, le applicazioni devono prima chiamare GetVisibleProviders e devono chiamare ScanNetwork solo quando le informazioni memorizzate nella cache sono precedenti.

Si tratta di un'operazione asincrona e ScanNetwork restituirà immediatamente. Se questo metodo restituisce correttamente (con S_OK), al termine dell'operazione di analisi, il sistema operativo chiamerà il metodo OnScanNetworkComplete di IMbnInterfaceEvents per notificare l'applicazione del completamento dell'operazione.

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.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione mbnapi.h

Vedi anche

IMbnInterface