Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A função GetInvertedIfStackTable recupera uma tabela de entradas de linha de pilha de interface de rede invertida que especificam a relação das interfaces de rede em uma pilha de interface.
Sintaxe
NETIOAPI_API GetInvertedIfStackTable(
_Out_ PMIB_INVERTEDIFSTACK_TABLE *Table
);
Parâmetros
-
Tabela [out]
Um ponteiro para um buffer que recebe a tabela de entradas de linha de pilha de interface invertida em uma estrutura de MIB_INVERTEDIFSTACK_TABLE.
Valor de retorno
GetInvertedIfStackTable retorna STATUS_SUCCESS se a função for bem-sucedida.
Se a função falhar, GetInvertedIfStackTable retorna um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
| STATUS_INVALID_PARAMETER | Um parâmetro inválido foi passado para a função. Este erro é retornado se um ponteiro de NULL é passado no parâmetro Table. |
| STATUS_NOT_ENOUGH_MEMORY | Recursos de memória insuficientes estão disponíveis para concluir a operação. |
| STATUS_NOT_FOUND | Nenhuma entrada de pilha de interface foi encontrada. |
| Outros | Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Comentários
A função GetInvertedIfStackTable enumera as interfaces de rede físicas e lógicas em uma pilha de interface em um computador local e retorna essas informações de forma invertida na estrutura MIB_INVERTEDIFSTACK_TABLE.
GetInvertedIfStackTable retorna entradas de pilha de interface em uma estrutura de MIB_INVERTEDIFSTACK_TABLE no buffer para o qual o parâmetro Table aponta. A estrutura MIB_INVERTEDIFSTACK_TABLE contém uma contagem de entrada de pilha de interface e uma matriz de estruturas de MIB_INVERTEDIFSTACK_ROW para cada entrada de pilha de interface.
A relação entre as interfaces na pilha de interface é que a interface com índice no HigherLayerInterfaceIndex membro da estrutura MIB_INVERTEDIFSTACK_ROW está imediatamente acima da interface com índice no LowerLayerInterfaceIndex membro da estrutura MIB_INVERTEDIFSTACK_ROW.
GetInvertedIfStackTable aloca memória para a estrutura MIB_INVERTEDIFSTACK_TABLE e as entradas MIB_INVERTEDIFSTACK_ROW nessa estrutura. Quando essas estruturas retornadas não são mais necessárias, seu driver deve liberar a memória chamando FreeMibTable.
Observe que a estrutura de MIB_INVERTEDIFSTACK_TABLE retornada para a qual o parâmetro Tabela aponta pode conter preenchimento para alinhamento entre o membro NumEntries e a primeira entrada de matriz MIB_INVERTEDIFSTACK_ROW na Tabela membro da estrutura MIB_INVERTEDIFSTACK_TABLE. O preenchimento para alinhamento também pode estar presente entre as entradas da matriz MIB_INVERTEDIFSTACK_ROW. Qualquer acesso a uma entrada de matriz MIB_INVERTEDIFSTACK_ROW deve pressupor que o preenchimento possa existir.