Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A função if_indextoname converte o índice local de uma interface de rede para o nome da interface ANSI.
Sintaxe
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parâmetros
InterfaceIndex [em]
O índice local para uma interface de rede.InterfaceName [out]
Um ponteiro para um buffer para manter a cadeia de caracteres ANSI terminada por 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.
Valor de retorno
Se essa função for bem-sucedida, if_indextoname retornará um ponteiro para uma cadeia de caracteres ANSI terminada por NULL que contém o nome da interface. Se essa função falhar, if_indextoname retornará um ponteiro de NULL
Comentários
A função if_indextoname mapeia um índice de interface em seu nome correspondente. Esta função é projetada como parte de extensões de soquete básicas para IPv6, conforme descrito pelo IETF em 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 preferido para converter identificadores de interface de rede. Você pode substituir a função if_indextoname por uma chamada para a funçãoConvertInterfaceIndexToLuid para converter um índice de interface em uma união de NET_LUID, seguida por uma chamada para a funçãoConvertInterfaceLuidToNameA para converter NET_LUID para o 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 encerramento é declarado no arquivo de cabeçalho Ntddndis.h. A NDIS_IF_MAX_STRING_SIZE é definida como sendo 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 o Ntddndis.h e Ifdef.h arquivos de cabeçalho diretamente.
Se a função if_indextoname falhar e retornar um ponteiro NULL, você não poderá determinar um código de erro.