Função InitializeIpForwardEntry (netioapi.h)
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 |