Compartilhar via


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.

Retornar valor

Nenhum

Comentários

Seu 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 MIB_IPFORWARD_ROW2 para inicializar.

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

  • ValidLifetime e PreferredLifetime
    Defina como um valor infinito,

  • Loopback, AutoconfigureAddress, Publish e Immortal
    Defina como TRUE.

  • SitePrefixLength, Metric e Protocol
    Defina como 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 CreateIpForwardEntry2 para adicionar a nova entrada de rota IP ao computador local.

Requisitos

Plataforma de destino

Universal

Versão

Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.

Cabeçalho

Netioapi.h (inclua Netioapi.h)

Biblioteca

Netio.lib

IRQL

< DISPATCH_LEVEL

Confira também

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2