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 [dentro, fora]
Um ponteiro para uma estrutura MIB_IPINTERFACE_ROW a ser inicializada. No retorno bem-sucedido, os campos nesse 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. Esse erro será retornado se um ponteiro NULL for passado no parâmetro Row |
Outros | Use a função FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado. |
Observações
Na saída, os membros da estrutura MIB_IPINTERFACE_ROW que o parâmetro Row aponta são inicializados da seguinte maneira.
da Família
Definido como AF_UNSPEC.InterfaceLuid
Defina como um valor não especificado.Todos os outros membros
Definido como zero.
O 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 alterar os campos na entrada MIB_IPINTERFACE_ROW que deseja modificar e, em seguida, chamar a funçãoSetIpInterfaceEntry.
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 |