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

• row [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 à qual esse parâmetro aponta é inicializada com valores padrão para uma entrada de rota IP.

Valor de retorno

Nenhum

Observações

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

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 que o parâmetro Row aponta são inicializados da seguinte maneira.

• ValidLifetime e preferredLifetime
  Definir como um valor infinito,

• loopback, AutoconfigureAddress, Publishe Immortal
  Definido como TRUE.

• SitePrefixLength, Metrice Protocol
  Definido como valores ilegais.

• Todos os outros membros
  Definido como zero.

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

Requisitos

Consulte também

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

notifyRouteChange2

SetIpForwardEntry2