Função InitializeIpForwardEntry

A função InitializeIpForwardEntry inicializa uma estrutura MIB_IPFORWARD_ROW2 com valores padrão para uma entrada de rota IP em um computador local.

Sintaxe

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Parâmetros

Linha [out]
Na entrada, um ponteiro para uma entrada de estrutura MIB_IPFORWARD_ROW2 para uma entrada de rota IP.

No retorno, a estrutura de MIB_IPFORWARD_ROW2 para a qual esse parâmetro aponta é inicializada com valores padrão para uma entrada de rota IP.

Valor de retorno

Nenhum

Comentários

Seu driver deve usar a função InitializeIpForwardEntry para inicializar os membros de uma entrada de estrutura de MIB_IPFORWARD_ROW2 com valores padrão para uma entrada de rota IP para uso posterior com a funçãoCreateIpForwardEntry2.

Na entrada, o driver deve passar InitializeIpForwardEntry uma nova estrutura de MIB_IPFORWARD_ROW2 para inicializar.

Na saída, os membros da estrutura de MIB_IPFORWARD_ROW2 para a qual o parâmetro Row aponta são inicializados da seguinte maneira.

ValidLifetime e PreferredLifetime
Definido como um valor infinito,
Loopback, AutoconfigureAddress, Publishe Immortal
Defina como TRUE.
SitePrefixLength, Metrice Protocol
Definir valores ilegais.
Todos os outros membros
Defina como zero.

Depois que um driver chama InitializeIpForwardEntry, o driver pode alterar os membros na entrada MIB_IPFORWARD_ROW2 que deseja modificar e, em seguida, chamar o CreateIpForwardEntry2 para adicionar a nova entrada de rota IP ao computador local.

Requerimentos

Plataforma de destino	Universal
Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Netioapi.h (inclui Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL