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 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.
Retornar valor
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. |
Comentários
Na saída, os membros da estrutura MIB_IPINTERFACE_ROW para a qual o parâmetro Row aponta são inicializados da seguinte maneira.
Família
Defina como AF_UNSPEC.InterfaceLuid
Defina como um valor não especificado.Todos os outros membros
Defina 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ção SetIpInterfaceEntry .
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 |