Função GetIfTable2

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 MIB_IF_TABLE2.

Valor de retorno

GetIfTable2 retornará STATUS_SUCCESS se a função for bem-sucedida.

Se a função falhar, GetIfTable2 retornará um dos seguintes códigos de erro:

Observações

A função GetIfTable2 enumera as interfaces lógicas e físicas em um computador local e retorna essas informações em uma estrutura MIB_IF_TABLE2.

O driver pode usar uma função semelhante, GetIfTable2Ex, para especificar o nível de interfaces a serem retornadas. Uma chamada para a 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 a qual o parâmetro tabela 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 de MIB_IF_TABLE2 e as entradas de MIB_IF_ROW2 nessa estrutura. Quando essas estruturas retornadas não forem mais necessárias, o driver deverá 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 no membro tabela 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 pressupor que o preenchimento possa existir.

Requisitos

Consulte também

FreeMibTable

GetIfTable2Ex

MIB_IF_TABLE2

MIB_IF_ROW2