So wird’s gemacht: Abrufen von Netzwerkadapter- und Ortsinformationen (HTML)

Artikel
12/12/2015

[ Dieser Artikel richtet sich an Windows 8.x- und Windows Phone 8.x-Entwickler, die Windows-Runtime-Apps schreiben. Wenn Sie für Windows 10 entwickeln, finden Sie weitere Informationen unter neueste Dokumentation]

In diesem Thema wird erläutert, wie Sie mit Klassen im Windows.Networking.Connectivity-Namespace LanIdentifier-Objekte abrufen, die Adaptern in einem Netzwerk zugeordnet sind, und auf Informationen zugreifen, mit denen die relative Position eines Netzwerkadapters in der Netzwerkinfrastruktur ermittelt werden kann.

Ein LanIdentifier-Objekt definiert Methoden, mit denen eine App Infrastruktur-/Port-ID-Werte zum Bestimmen der Position und den einem Netzwerkadapter zugeordneten ID-Wert abruft. Diese ID wird als ConnectionProfile-Eigenschaft angegeben, um die Zuordnung zur Netzwerkverbindung deutlich zu machen.

Wissenswertes

Technologien

Windows.Networking.Connectivity

Voraussetzungen

Die folgenden Beispiele verwenden JavaScript und basieren auf dem Netzwerkinformationsbeispiel. Allgemeine Informationen zum Erstellen einer Windows-Runtime-App mit JavaScript finden Sie unter Erstellen Ihrer ersten Windows-Runtime-App mit JavaScript.

Abrufen aller LanIdentifier-Objekte

Die erste Beispielfunktion ruft die NetworkInformation.getLanIdentifiers-Methode auf, um ein LanIdentifier-Objektarray abzurufen.

var networkInfo = Windows.Networking.Connectivity.NetworkInformation;

function DisplayLanIdentifiers() {
     var lanIdentifier = "";
     try {
         var lanIdentifiers = networkInfo.getLanIdentifiers();
         if (lanIdentifiers.length !== 0) {
             lanIdentifier += "Number of LAN Identifiers retrieved: " + lanIdentifiers.length + "\n\r";
             lanIdentifier += "=============================================\n\r";
             for (var i = 0; i < lanIdentifiers.length; i++) {
                 //Display Lan Identifier data for each identifier
                 lanIdentifier += getLanIdentifierData(lanIdentifiers[i]);
                 lanIdentifier += "----------------------------------------------------------------\n\r";
             }
             mySample.displayStatus(lanIdentifier);
         }
         else {
             mySample.displayStatus("No LAN identifier data found");
         }
     }

     catch (e) {
         mySample.displayError("Exception Caught: " + e + "\n\r");
     }
 }

Anzeigen der Eigenschaften eines LanIdentifier-Objekts

Anschließend übergeben Sie ein LanIdentifier-Objekt, das im vorherigen Schritt zurückgegeben wurde, an die folgende Beispielfunktion, um die konkreten Werte für die Infrastruktur-ID, die Port-ID und die Netzwerkadapter-ID anzuzeigen.

var networkInfo = Windows.Networking.Connectivity.NetworkInformation;
  
function getLanIdentifierData(lanIdentifier) {
    var lanIdentifierData = "";
    var i = 0;
    try {
        if (lanIdentifier === null) {
            return "";
        }
        if (lanIdentifier.infrastructureId !== null) {
            lanIdentifierData += "Infrastructure Type: " + lanIdentifier.infrastructureId.type + "\n\r";
            lanIdentifierData += "Infrastructure Value: [";
            for (i = 0; i < lanIdentifier.infrastructureId.value.length; i++) {
                //Display the Infrastructure value array
                lanIdentifierData += lanIdentifier.infrastructureId.value[i].toString(16) + " ";
            }
            lanIdentifierData += "]\n\r";
        }
        if (lanIdentifier.portId !== null) {
            lanIdentifierData += "Port Type : " + lanIdentifier.portId.type + "\n\r";
            lanIdentifierData += "Port Value: [";
            for (i = 0; i < lanIdentifier.portId.value.length; i++) {
                //Display the PortId value array
                lanIdentifierData += lanIdentifier.portId.value[i].toString(16) + " ";
            }
            lanIdentifierData += "]\n\r";
        }
        if (lanIdentifier.networkAdapterId !== null) {
            lanIdentifierData += "Network Adapter Id : " + lanIdentifier.networkAdapterId + "\n\r";
        }
    }
    catch (e) {
        mySample.displayError("Exception Caught: " + e + "\n\r");
    }
    return lanIdentifierData;
}