Função InitializeUnicastIpAddressEntry (netioapi.h)

Artigo
03/15/2023

A função InitializeUnicastIpAddressEntry inicializa uma estrutura MIB_UNICASTIPADDRESS_ROW com valores padrão para uma entrada de endereço IP unicast no computador local.

Sintaxe

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

Parâmetros

[out] Row

Na entrada, um ponteiro para uma entrada de estrutura MIB_UNICASTIPADDRESS_ROW para uma entrada de endereço IP unicast. No retorno, a estrutura de MIB_UNICASTIPADDRESS_ROW apontada por esse parâmetro é inicializada com valores padrão para um endereço IP unicast.

Retornar valor

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

Comentários

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

A função InitializeUnicastIpAddressEntry deve ser usada para inicializar os membros de uma entrada de estrutura MIB_UNICASTIPADDRESS_ROW com valores padrão para um endereço IP unicast para uso posterior com a função CreateUnicastIpAddressEntry .

Na entrada, InitializeUnicastIpAddressEntry deve ser passada uma nova estrutura MIB_UNICASTIPADDRESS_ROW para inicializar.

Na saída, o membro PrefixOrigin da estrutura MIB_UNICASTIPADDRESS_ROW apontado pelo parâmetro Row será inicializado como IpPrefixOriginUnchanged, o membro SuffixOrigin será inicializado para IpSuffixOriginUnchanged e o membro OnLinkPrefixLength será inicializado para um valor ilegal. Além disso, os membros PreferredLifetime e ValidLifetime são definidos como infinitos, o membro SkipAsSource é definido como FALSE e outros campos são inicializados como zero.

Depois de chamar InitializeUnicastIpAddressEntry, um aplicativo pode alterar os membros na entrada MIB_UNICASTIPADDRESS_ROW que deseja modificar e, em seguida, chamar CreateUnicastIpAddressEntry para adicionar o novo endereço IP unicast 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