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 GetIfTable2 recupera a tabela de interface MIB-II.
Sintaxe
NETIOAPI_API GetIfTable2(
_Out_ PMIB_IF_TABLE2 *Table
);
Parâmetros
-
Tabela [out]
Um ponteiro para um buffer que recebe a tabela de interfaces em uma estrutura de MIB_IF_TABLE2.
Valor de retorno
GetIfTable2 retorna STATUS_SUCCESS se a função for bem-sucedida.
Se a função falhar, GetIfTable2 retornará um dos seguintes códigos de erro:
| Código de retorno | Descrição |
|---|---|
| STATUS_NOT_ENOUGH_MEMORY | Recursos de memória insuficientes estão disponíveis para concluir a operação. |
| Outros | Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Comentários
A função GetIfTable2 do enumera as interfaces lógicas e físicas em um computador local e retorna essas informações em uma estrutura MIB_IF_TABLE2.
Seu driver pode usar uma função semelhante, GetIfTable2Ex, para especificar o nível de interfaces a serem retornadas. Uma chamada para o função GetIfTable2Ex com o parâmetro Level definido como MibIfTableNormal recupera os mesmos resultados que chamar a função GetIfTable2.
GetIfTable2 retorna interfaces em uma estrutura de MIB_IF_TABLE2 no buffer para o qual o parâmetro Table aponta. A estrutura MIB_IF_TABLE2 contém uma contagem de interfaces e uma matriz de estruturas MIB_IF_ROW2 para cada interface. GetIfTable2 aloca memória para a estrutura MIB_IF_TABLE2 e as entradas MIB_IF_ROW2 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_IF_TABLE2 retornada para a qual o parâmetro Table aponta pode conter preenchimento para alinhamento entre o membro NumEntries e a primeira entrada de matriz MIB_IF_ROW2 na Table membro da estrutura MIB_IF_TABLE2. O preenchimento para alinhamento também pode estar presente entre as entradas de matriz MIB_IF_ROW2. Qualquer acesso a uma entrada de matriz MIB_IF_ROW2 deve assumir que o preenchimento pode existir.