Função InitializeIpForwardEntry (netioapi.h)

Artigo
03/15/2023

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

Sintaxe

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

Parâmetros

[out] Row

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 apontada por esse parâmetro é inicializada com valores padrão para uma entrada de rota IP.

Retornar valor

Essa função não retorna um valor.

Comentários

A função InitializeIpForwardEntry é definida no Windows Vista e posterior.

A função InitializeIpForwardEntry deve ser usada 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, InitializeIpForwardEntry deve receber uma nova estrutura MIB_IPFORWARD_ROW2 para inicializar.

Na saída, os membros ValidLifetime e PreferredLifetime da estrutura MIB_IPFORWARD_ROW2 apontada pelo parâmetro Row serão inicializados para infinito e os membros Loopback, AutoconfigureAddress, Publish e Immortal serão inicializados como TRUE. Além disso, os membros SitePrefixLength, Metric e Protocol são definidos como um valor inválido e outros campos são inicializados como zero.

Depois de chamar InitializeIpForwardEntry, um aplicativo 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

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	netioapi.h (inclua Iphlpapi.h)
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll