função if_indextoname

A função if_indextoname converte o índice local para 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 por NULL. Se if_indextoname for bem-sucedido, InterfaceName conterá o nome da interface ANSI. O comprimento, em bytes, do buffer ao 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

Observações

A função if_indextoname mapeia um índice de interface para seu nome 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_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çãoConvertInterfaceIndexToLuidpara converter um índice de interface em uma união NET_LUID, seguida por uma chamada à funçãoConvertInterfaceLuidToNameApara converter NET_LUID no nome da interface ANSI.

O comprimento, em bytes, do buffer que o 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.

Se a função if_indextoname falhar e retornar um ponteiro de NULL, você não poderá determinar um código de erro.

Requisitos

Consulte também

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID