função if_indextoname
A função if_indextoname converte o índice local de um adaptador de rede para o nome da interface ANSI.
Sintaxe
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parâmetros
InterfaceIndex [in]
O índice local para um adaptador de rede.InterfaceName [out]
Um ponteiro para um buffer para manter a cadeia de caracteres ANSI terminada em NULL. Se if_indextoname for bem-sucedido, InterfaceName conterá o nome da interface ANSI. O comprimento, em bytes, do buffer para o qual esse parâmetro aponta deve ser igual ou maior que IF_NAMESIZE. Para obter mais informações sobre IF_NAMESIZE, consulte a seção Comentários a seguir.
Retornar valor
Se essa função for bem-sucedida, if_indextoname retornará um ponteiro para uma cadeia de caracteres ANSI terminada em NULL que contém o nome da interface. Se essa função falhar, if_indextoname retornará um ponteiro NULL
Comentários
A função if_indextoname mapeia um índice de interface para seu nome correspondente. Essa função foi projetada como parte de extensões de soquete básicas para IPv6, conforme descrito pelo IETF no RFC 2553.
A função if_indextoname é 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_indextoname por uma chamada para a função ConvertInterfaceIndexToLuid para converter um índice de interface em uma união NET_LUID , seguido por uma chamada para a função ConvertInterfaceLuidToNameA para converter NET_LUID no nome da interface ANSI.
O comprimento, em bytes, do buffer para o qual o parâmetro InterfaceName aponta deve ser igual ou maior que IF_NAMESIZE. O valor IF_NAMESIZE é definido no arquivo de cabeçalho Netioapi.h como igual a NDIS_IF_MAX_STRING_SIZE. O comprimento máximo de um nome de interface, NDIS_IF_MAX_STRING_SIZE, sem o caractere NULL de terminação é declarado no arquivo de cabeçalho Ntddndis.h. O NDIS_IF_MAX_STRING_SIZE é definido como a constante IF_MAX_STRING_SIZE definida no arquivo de cabeçalho Ifdef.h.
Observação
Os arquivos de cabeçalho Ntddndis.h e Ifdef.h são incluídos automaticamente no arquivo de cabeçalho Netioapi.h . Você nunca deve usar os arquivos de cabeçalho Ntddndis.h e Ifdef.h diretamente.
Se a função if_indextoname falhar e retornar um ponteiro NULL , 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. |
parâmetro |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |