if_indextoname işlevi

if_indextoname işlevi, ağ arabiriminin yerel dizinini ANSI arabirim adına dönüştürür.

Sözdizimi

PCHAR NETIOAPI_API_ if_indextoname(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PCHAR       InterfaceName
);

Parametre

• InterfaceIndex [in]
  Ağ arabirimi için yerel dizin.

• InterfaceName [out]
  NULL ile sonlandırılan ANSI dizesini tutmak için arabelleğe yönelik bir işaretçi. if_indextoname başarılı olursa InterfaceName ANSI arabirim adını içerir. Bu parametrenin işaret olduğu arabelleğin bayt cinsinden uzunluğu IF_NAMESIZE eşit veya ondan büyük olmalıdır. IF_NAMESIZE hakkında daha fazla bilgi için aşağıdaki Açıklamalar bölümüne bakın.

Dönüş değeri

Bu işlev başarılı olursa, if_indextoname arabirim adını içeren NULL ile sonlandırılan ANSI dizesine bir işaretçi döndürür. Bu işlev başarısız olursa, if_indextoname bir NULL işaretçisi döndürür

Açıklamalar

if_indextoname işlevi bir arabirim dizinini ilgili adıyla eşler. Bu işlev, RFC 2553içindeki IETF tarafından açıklandığı gibi IPv6 için temel yuva uzantılarının bir parçası olarak tasarlanmıştır.

if_indextoname işlevi Unix ortamlarına sahip sürücülerin taşınabilirliği için uygulanır, ancak ConvertInterfaceXxx işlevleri ağ arabirimi tanımlayıcılarını dönüştürmek için tercih edilen yöntemdir. if_indextoname işlevini, arabirim dizinini NET_LUID bir birleşime dönüştürmek için ConvertInterfaceIndexToLuid işlevine yapılan bir çağrı ve ardından ConvertInterfaceLuidToNameA işlevine çağrı yaparak NET_LUID ANSI arabirim adına dönüştürebilirsiniz.

InterfaceName parametresinin işaret etmesi gereken arabelleğin bayt cinsinden uzunluğu IF_NAMESIZE eşit veya daha büyük olmalıdır. IF_NAMESIZE değeri Netioapi.h üst bilgi dosyasında NDIS_IF_MAX_STRING_SIZE eşit olarak tanımlanır. Sonlandırıcı NULL karakteri olmayan bir arabirim adının uzunluğu üst sınırı NDIS_IF_MAX_STRING_SIZE Ntddndis.h üst bilgi dosyasında bildirilir. NDIS_IF_MAX_STRING_SIZE, Ifdef.h üst bilgi dosyasında tanımlanan IF_MAX_STRING_SIZE sabiti olarak tanımlanır.

Not

Ntddndis.h ve Ifdef.h üst bilgi dosyaları otomatik olarak Netioapi.h üst bilgi dosyasına eklenir. Ntddndis.h ve Ifdef.h üst bilgi dosyalarını doğrudan asla kullanmamalısınız.

if_indextoname işlevi başarısız olursa ve NULL işaretçisi döndürürse, hata kodunu belirleyemezsiniz.

Gereksinim -leri

Hedef platform	Evrensel
Sürüm	Windows Vista ve Windows işletim sistemlerinin sonraki sürümlerinde kullanılabilir.
Üstbilgi	Netioapi.h (Netioapi.h içerir)
Kütüphane	Netio.lib
IRQL	PASSIVE_LEVEL

Ayrıca bkz.

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToNameA

NET_LUID