função if_nametoindex
A função if_nametoindex converte o nome da interface ANSI para 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 por NULL que contém o nome da interface.
Valor de retorno
Se a função for bem-sucedida, if_nametoindex retornará o índice de interface local. Se a função falhar, if_nametoindex retornará zero.
Observações
A função if_nametoindex mapeia um nome de interface para seu índice correspondente. Essa função foi projetada como parte das extensões básicas de soquete para IPv6, conforme descrito pelo IETF em 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 à função ConvertInterfaceNameToLuidA para converter o nome da interface ANSI em uma união de NET_LUID, seguida por uma chamada para a função ConvertInterfaceLuidToIndex para converter NET_LUID no í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 |