if_indextoname función
La función if_indextoname convierte el índice local de una interfaz de red en el nombre de la interfaz ANSI.
Sintaxis
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parámetros
InterfaceIndex [in]
Índice local de una interfaz de red.InterfaceName [out]
Puntero a un búfer que contiene la cadena ANSI terminada en NULL. Si if_indextoname se realiza correctamente, InterfaceName contiene el nombre de la interfaz ANSI. Longitud, en bytes, del búfer al que apunta este parámetro debe ser igual o mayor que IF_NAMESIZE. Para obtener más información sobre IF_NAMESIZE, vea la siguiente sección Comentarios.
Valor devuelto
Si esta función se ejecuta correctamente, if_indextoname devuelve un puntero a una cadena ANSI terminada en NULL que contiene el nombre de la interfaz. Si se produce un error en esta función, if_indextoname devuelve un puntero NULL .
Observaciones
La función if_indextoname asigna un índice de interfaz a su nombre correspondiente. Esta función está diseñada como parte de las extensiones de socket básicas para IPv6, como se describe en IETF en RFC 2553.
La función if_indextoname se implementa para la portabilidad de controladores con entornos Unix, pero las funciones ConvertInterfaceXxx son el método preferido para convertir identificadores de interfaz de red. Puede reemplazar la función if_indextoname por una llamada a la función ConvertInterfaceIndexToLuid para convertir un índice de interfaz en una unión de NET_LUID , seguida de una llamada a la función ConvertInterfaceLuidToNameA para convertir NET_LUID al nombre de la interfaz ANSI.
Longitud, en bytes, del búfer al que apunta el parámetro InterfaceName debe ser igual o mayor que IF_NAMESIZE. El valor de IF_NAMESIZE se define en el archivo de encabezado Netioapi.h como igual a NDIS_IF_MAX_STRING_SIZE. La longitud máxima de un nombre de interfaz, NDIS_IF_MAX_STRING_SIZE, sin el carácter NULL de terminación se declara en el archivo de encabezado Ntddndis.h. El NDIS_IF_MAX_STRING_SIZE se define como la constante IF_MAX_STRING_SIZE que se define en el archivo de encabezado Ifdef.h.
Nota
Los archivos de encabezado Ntddndis.h y Ifdef.h se incluyen automáticamente en el archivo de encabezado Netioapi.h . Nunca debe usar los archivos de encabezado Ntddndis.h y Ifdef.h directamente.
Si se produce un error en la función if_indextoname y devuelve un puntero NULL , no puede determinar un código de error.
Requisitos
Plataforma de destino |
Universal |
Versión |
Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
Encabezado |
Netioapi.h (incluya Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |