Função InitializeIpInterfaceEntry

A função InitializeIpInterfaceEntry inicializa os membros de uma entrada de estrutura MIB_IPINTERFACE_ROW com valores padrão.

Sintaxe

VOID NETIOAPI_API_ InitializeIpInterfaceEntry(
  _Inout_ PMIB_IPINTERFACE_ROW Row
);

Parâmetros

Linha [entrada, saída]
Um ponteiro para uma estrutura de MIB_IPINTERFACE_ROW a ser inicializada. No retorno bem-sucedido, os campos neste parâmetro são inicializados com informações padrão para uma interface no computador local.

Valor de retorno

InitializeIpInterfaceEntry retornará STATUS_SUCCESS se a função for bem-sucedida.

Se a função falhar, InitializeIpInterfaceEntry retornará um dos seguintes códigos de erro:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um parâmetro inválido foi passado para a função. Este erro é retornado se um ponteiro de NULL é passado no parâmetro Row
Outros	Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

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

para famílias
Defina como AF_UNSPEC.
InterfaceLuid
Defina como um valor não especificado.
Todos os outros membros
Defina como zero.

Seu driver deve usar a função InitializeIpInterfaceEntry para inicializar os campos de uma entrada de estrutura MIB_IPINTERFACE_ROW com valores padrão. Um driver pode então alterar os campos na entrada MIB_IPINTERFACE_ROW que deseja modificar e, em seguida, chamar o função SetIpInterfaceEntry.

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