Informazioni sull'API Network List Manager

L'ambiente di rete di Microsoft Windows consente ai computer multihomed di connettersi contemporaneamente a diverse reti. Potrebbero essere disponibili più reti wireless insieme a CONNESSIONI LAN e connessioni remote. Network List Manager identifica le reti disponibili e restituisce i dati degli attributi di rete all'applicazione.

L'API Network List Manager interagisce con il servizio Network List Manager per identificare e recuperare le proprietà di ogni rete a cui si connette il PC. Ogni rete viene identificata in modo univoco con una firma di rete in base alle proprietà identificabili in modo univoco della rete. Quando un'applicazione esegue la registrazione per le notifiche di Network List Manager, l'applicazione riceve notifiche sulla disponibilità di nuove connessioni di rete o modifiche alle connessioni di rete esistenti. Le applicazioni possono regolare la logica a seconda della rete a cui sono connesse; connessione di rete a cui sono connessi; o quali sono le proprietà di rete. Con queste applicazioni informative è possibile ottimizzare le azioni in base alle condizioni di rete correnti

Windows Vista introduce nuove interfacce che possono essere usate per ottenere informazioni dettagliate su queste caratteristiche di rete e altro ancora. Con l'interfaccia INetworkListManager è facile enumerare tutte le reti (INetwork) che un computer ha mai visto, o solo le reti connesse o solo le reti disconnesse. L'interfaccia INetworkListManager semplifica anche l'enumerazione delle interfacce di rete in un computer.

L'interfaccia INetwork viene usata per determinare le proprietà di una connessione di rete: nome, descrizione, ID, gestito/autenticato, connesso/disconnesso e altro ancora. È possibile che una singola rete sia connessa a diverse interfacce, quindi tramite un'interfaccia INetwork è anche possibile enumerare le istanze dell'interfaccia INetwork in uso.

L'interfaccia INetwork indica le proprietà pertinenti di un'interfaccia: ID, GUID, Type (gestito, autenticato) e State (connesso, disconnesso, V4 Local, V4 Internet, V6 Local, V6 Internet). V4 Local indica l'accesso locale al protocollo Internet versione 4 (IPv4). V4 Internet significa IPv4 con accesso a Internet. V6 Local e V6 Internet indicano IPv6.

La radice dell'albero degli oggetti per Percorso di rete è l'interfaccia INetworkListManager . Questa interfaccia viene implementata nella coclasse CLSID_NetworkListManager . Per usare questa interfaccia, è necessario creare l'oggetto COM CLSID_NetworkListManager , come illustrato di seguito:

#include <windows.h>
#include <netlistmgr.h>

#pragma comment(lib, "ole32.lib")

void main()
{
    INetworkListManager *pNetworkListManager = NULL; 
    HRESULT hr = CoCreateInstance(CLSID_NetworkListManager, NULL,
            CLSCTX_ALL, IID_INetworkListManager,
            (LPVOID *)&pNetworkListManager);
}