Função if_nametoindex
A função if_nametoindex converte o nome da interface ANSI de um adaptador de rede para o índice local da interface.
Sintaxe
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
Parâmetros
- InterfaceName [in]
Um ponteiro para uma cadeia de caracteres ANSI terminada em NULL que contém o nome da interface.
Retornar valor
Se a função for bem-sucedida, if_nametoindex retornará o índice da interface local. Se a função falhar, if_nametoindex retornará zero.
Comentários
A função if_nametoindex mapeia um nome de interface para seu índice correspondente. Essa função foi projetada como parte das extensões de soquete básicas para IPv6, conforme descrito pelo IETF no RFC 2553.
A função if_nametoindex é implementada para portabilidade de drivers com ambientes Unix, mas as funções ConvertInterfaceXxx são o método preferencial para converter identificadores de interface de rede. Você pode substituir a função if_nametoindex por uma chamada para a função ConvertInterfaceNameToLuidA para converter o nome da interface ANSI em uma união NET_LUID , seguida por uma chamada para a função ConvertInterfaceLuidToIndex para converter NET_LUID para o índice de interface local.
Se a função if_nametoindex falhar e retornar zero, você não poderá determinar um código de erro.
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 |
PASSIVE_LEVEL |