Função InitializeUnicastIpAddressEntry
A função InitializeUnicastIpAddressEntry inicializa uma estrutura 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 MIB_UNICASTIPADDRESS_ROW para uma entrada de endereço IP unicast. No retorno, a estrutura MIB_UNICASTIPADDRESS_ROW para a qual esse parâmetro aponta é inicializada com valores padrão para um endereço IP unicast.
Retornar valor
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ção CreateUnicastIpAddressEntry .
Na entrada, o driver deve passar InitializeUnicastIpAddressEntry uma nova estrutura MIB_UNICASTIPADDRESS_ROW para inicializar.
Na saída, os membros da estrutura MIB_UNICASTIPADDRESS_ROW para a qual o parâmetro Row aponta são inicializados da seguinte maneira.
Prefixorigin
Defina como o valor IpPrefixOriginUnchanged da enumeração NL_PREFIX_ORIGIN .Suffixorigin
Defina como o valor IpSuffixOriginUnchanged da enumeração NL_PREFIX_ORIGIN .OnLinkPrefixLength
Defina como um valor inválido.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 CreateUnicastIpAddressEntry para adicionar o novo endereço IP unicast ao computador local.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |