Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La funzione GetInvertedIfStackTable recupera una tabella di voci di riga dello stack dell'interfaccia di rete invertita che specificano la relazione delle interfacce di rete in uno stack di interfacce.
Sintassi
NETIOAPI_API GetInvertedIfStackTable(
_Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);
Parametri
-
tabella [out]
Puntatore a un buffer che riceve la tabella delle voci di riga dello stack di interfacce invertite in una struttura MIB_INVERTEDIFSTACK_TABLE.
Valore restituito
getInvertedIfStackTable restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione non riesce, GetInvertedIfStackTable restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Table. |
| STATUS_NOT_ENOUGH_MEMORY | Per completare l'operazione sono disponibili risorse di memoria insufficienti. |
| STATUS_NOT_FOUND | Non sono state trovate voci dello stack di interfacce. |
| Altro | Usare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Osservazioni
La funzione GetInvertedIfStackTable enumera le interfacce di rete fisiche e logiche in uno stack di interfacce in un computer locale e restituisce queste informazioni in un formato invertito nella struttura MIB_INVERTEDIFSTACK_TABLE.
GetInvertedIfStackTable restituisce voci dello stack di interfacce in una struttura MIB_INVERTEDIFSTACK_TABLE nel buffer a cui punta il parametro Table. La struttura MIB_INVERTEDIFSTACK_TABLE contiene un conteggio delle voci dello stack di interfacce e una matrice di strutture MIB_INVERTEDIFSTACK_ROW per ogni voce dello stack di interfacce.
La relazione tra le interfacce nello stack di interfaccia è che l'interfaccia con indice nel membro HigherLayerInterfaceIndex della struttura MIB_INVERTEDIFSTACK_ROW è immediatamente sopra l'interfaccia con indice nel LowerLayerInterfaceIndex membro della struttura MIB_INVERTEDIFSTACK_ROW.
GetInvertedIfStackTable alloca memoria per la struttura MIB_INVERTEDIFSTACK_TABLE e le voci MIB_INVERTEDIFSTACK_ROW in questa struttura. Quando queste strutture restituite non sono più necessarie, il driver deve liberare la memoria chiamando FreeMibTable.
Si noti che la struttura MIB_INVERTEDIFSTACK_TABLE restituita a cui punta il parametro Table potrebbe contenere spaziatura interna per l'allineamento tra il membro NumEntries e la prima voce di matrice MIB_INVERTEDIFSTACK_ROW nel membro Table della struttura MIB_INVERTEDIFSTACK_TABLE. La spaziatura interna per l'allineamento potrebbe essere presente anche tra le voci della matrice MIB_INVERTEDIFSTACK_ROW. Qualsiasi accesso a una voce di matrice MIB_INVERTEDIFSTACK_ROW deve presupporre che esista una spaziatura interna.
Fabbisogno
Piattaforma di destinazione |
universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |