Informacje o interfejsie API Menedżera Listy Sieci

Środowisko sieciowe systemu Microsoft Windows umożliwia komputerom wieloadresowym jednoczesne łączenie się z kilkoma sieciami. Może istnieć wiele sieci bezprzewodowych dostępnych wraz z siecią LAN i połączeniami telefonicznymi. Menedżer listy sieci identyfikuje dostępne sieci i zwraca dane atrybutów sieciowych do aplikacji.

Interfejs API menedżera list sieci współdziała z usługą Network List Manager w celu identyfikowania i pobierania właściwości każdej sieci, z którą komputer nawiązuje połączenie. Każda sieć jest unikatowo identyfikowana za pomocą sygnatury sieciowej na podstawie unikatowych identyfikowalnych właściwości tej sieci. Gdy aplikacja rejestruje się na potrzeby powiadomień Menedżera listy sieci, aplikacja otrzymuje powiadomienia o dostępności nowych połączeń sieciowych lub zmianach w istniejących połączeniach sieciowych. Aplikacje mogą dostosować logikę w zależności od tego, z którą siecią są połączone; połączenie sieciowe, z którym są połączone; lub jakie są właściwości sieci. Dzięki tym informacjom aplikacje mogą dostosować swoje akcje na podstawie bieżących warunków sieciowych

System Windows Vista wprowadza nowe interfejsy, które mogą służyć do uzyskiwania szczegółowych informacji o tych cechach sieci i nie tylko. Dzięki interfejsowi INetworkListManager łatwo jest wyliczyć wszystkie sieci (INetwork), które komputer kiedykolwiek widział, lub tylko sieci połączone, albo tylko sieci rozłączone. Interfejs INetworkListManager ułatwia również wyliczanie interfejsów sieciowych na komputerze.

Interfejs INetwork służy do określania właściwości połączenia sieciowego: nazwy, opisu, identyfikatora, zarządzanego/uwierzytelnionego, połączonego/rozłączonego i nie tylko. Istnieje możliwość, że jedna sieć jest połączona z kilkoma interfejsami, więc za pośrednictwem interfejsu INetwork można również wyliczyć wystąpienia używanego interfejsu INetwork.

Interfejs INetwork informuje o odpowiednich właściwościach interfejsu: ID, GUID, Typ (zarządzany, uwierzytelniony) i Stan (połączony, odłączony, V4 Lokalny, V4 Internet, V6 Lokalny, V6 Internet). V4 Local oznacza dostęp lokalny protokołu internetowego w wersji 4 (IPv4). V4 Internet oznacza IPv4 z dostępem do Internetu. V6 Lokalny i V6 Internetowy odnoszą się do IPv6.

Korzeń drzewa obiektów dla lokalizacji sieciowej to interfejs INetworkListManager. Ten interfejs jest implementowany na CLSID_NetworkListManager coclass. Aby użyć tego interfejsu, należy utworzyć obiekt CLSID_NetworkListManager COM, jak pokazano:

#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);
}