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 .
Retornar valor
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:
| 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 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 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 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 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 Table da estrutura MIB_IF_TABLE2. O preenchimento para alinhamento também pode estar presente entre as entradas da matriz MIB_IF_ROW2. Qualquer acesso a uma entrada de matriz MIB_IF_ROW2 deve pressupor que o preenchimento possa existir.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
parâmetro |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |