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