De functie GetIfStackTable

De functie GetIfStackTable haalt een tabel met rijvermeldingen voor de netwerkinterfacestack op die de relatie van de netwerkinterfaces op een interfacestack opgeven.

Syntaxis

NETIOAPI_API GetIfStackTable(
  _Out_ PMIB_IFSTACK_TABLE *Table
);

Parameters

• Tabel [uit]
  Een aanwijzer naar een buffer die de tabel met rijvermeldingen van de interfacestack in een MIB_IFSTACK_TABLE structuur ontvangt.

Retourwaarde

GetIfStackTable- retourneert STATUS_SUCCESS als de functie slaagt.

Als de functie mislukt, retourneert GetIfStackTable een van de volgende foutcodes:

Retourcode	Beschrijving
STATUS_INVALID_PARAMETER	Er is een ongeldige parameter doorgegeven aan de functie. Deze fout wordt geretourneerd als een NULL- aanwijzer wordt doorgegeven in de parameter Tabel.
STATUS_NOT_ENOUGH_MEMORY	Er zijn onvoldoende geheugenbronnen beschikbaar om de bewerking te voltooien.
STATUS_NOT_FOUND	Er zijn geen interfacestackvermeldingen gevonden.
Overige	Gebruik de functie FormatMessage om de berichttekenreeks voor de geretourneerde fout op te halen.

Opmerkingen

De Functie GetIfStackTable inventariseert de fysieke en logische netwerkinterfaces op een interfacestack op een lokale computer en retourneert deze informatie in een MIB_IFSTACK_TABLE structuur.

Interfacestackvermeldingen worden geretourneerd in een MIB_IFSTACK_TABLE structuur in de buffer waarnaar de Tabel parameter verwijst. De MIB_IFSTACK_TABLE structuur bevat een invoeraantal interfacestacks en een matrix van MIB_IFSTACK_ROW structuren voor elke interfacestackvermelding.

De relatie tussen de interfaces in de interfacestack is dat de interface met index in de HigherLayerInterfaceIndex lid van de MIB_IFSTACK_ROW structuur zich direct boven de interface bevindt met index in de LowerLayerInterfaceIndex lid van de MIB_IFSTACK_ROW-structuur.

Geheugen wordt toegewezen door de GetIfStackTable- functie voor de MIB_IFSTACK_TABLE structuur en de MIB_IFSTACK_ROW vermeldingen in deze structuur. Wanneer deze geretourneerde structuren niet meer nodig zijn, moet uw stuurprogramma het geheugen vrijmaken door FreeMibTable-aan te roepen.

Houd er rekening mee dat de geretourneerde MIB_IFSTACK_TABLE structuur waarnaar de parameter Tabel verwijst, mogelijk opvulling bevat voor uitlijning tussen het NumEntries lid en de eerste MIB_IFSTACK_ROW matrixvermelding in de Tabel lid van de MIB_IFSTACK_TABLE-structuur. Opvulling voor uitlijning kan ook aanwezig zijn tussen de MIB_IFSTACK_ROW matrixvermeldingen. Elke toegang tot een MIB_IFSTACK_ROW matrixvermelding moet ervan uitgaan dat opvulling bestaat.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	< DISPATCH_LEVEL

Zie ook

FreeMibTable-

GetIfEntry2-

GetIfTable2-

GetInvertedIfStackTable-

GetIpInterfaceEntry-

InitializeIpInterfaceEntry-

MIB_IF_ROW2

MIB_IF_TABLE2

MIB_IFSTACK_ROW

MIB_IFSTACK_TABLE

MIB_INVERTEDIFSTACK_ROW

MIB_INVERTEDIFSTACK_TABLE

MIB_IPINTERFACE_ROW

NotifyIpInterfaceChange-

SetIpInterfaceEntry-