Função InitializeUnicastIpAddressEntry

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

Sintaxe

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parâmetros

Linha [out]
Na entrada, um ponteiro para uma entrada de estrutura de MIB_UNICASTIPADDRESS_ROW para uma entrada de endereço IP unicast. No retorno, a estrutura de MIB_UNICASTIPADDRESS_ROW para a qual esse parâmetro aponta é inicializada com valores padrão para um endereço IP unicast.

Valor de retorno

Nenhum

Comentários

Seu driver deve usar a função InitializeUnicastIpAddressEntry 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çãoCreateUnicastIpAddressEntry.

Na entrada, o driver deve passar InitializeUnicastIpAddressEntry uma nova estrutura de MIB_UNICASTIPADDRESS_ROW para inicializar.

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

PrefixOrigin
Defina como o IpPrefixOriginUnchanged valor da enumeração NL_PREFIX_ORIGIN.
SuffixOrigin
Defina como o IpSuffixOriginUnchanged valor da enumeração NL_PREFIX_ORIGIN.
OnLinkPrefixLength
Defina como um valor ilegal.
PreferredLifetime e ValidLifetime
Defina como valores infinitos.
SkipAsSource
Defina como FALSE.
Todos os outros membros
Defina como zero.

Depois que um driver chama InitializeUnicastIpAddressEntry, o driver pode alterar os membros na entrada MIB_UNICASTIPADDRESS_ROW que deseja modificar e, em seguida, chamar o CreateUnicastIpAddressEntry para adicionar o novo endereço IP unicast ao computador local.

Requerimentos

Plataforma de destino	Universal
Versão	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho	Netioapi.h (inclui Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL