if_nametoindex işlevi

if_nametoindex işlevi, ağ arabiriminin ANSI arabirim adını arabirimin yerel dizinine dönüştürür.

Sözdizimi

NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  _In_ PCSTR InterfaceName
);

Parametre

• InterfaceName [in]
  Arabirim adını içeren NULL ile sonlandırılan ANSI dizesinin işaretçisi.

Dönüş değeri

İşlev başarılı olursa, if_nametoindex yerel arabirim dizinini döndürür. İşlev başarısız olursa if_nametoindex sıfır döndürür.

Açıklamalar

if_nametoindex işlevi, bir arabirim adını ilgili dizinine 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_nametoindex 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_nametoindex işlevini, ANSI arabirim adını NET_LUID bir birleşime dönüştürmek için ConvertInterfaceNameToLuidA işlevine yapılan bir çağrıyla ve ardından NET_LUID yerel arabirim dizinine dönüştürmek için ConvertInterfaceLuidToIndex işlevine yapılan bir çağrıyla değiştirebilirsiniz.

if_nametoindex işlevi başarısız olursa ve sıfır 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.

ConvertInterfaceLuidToIndex

ConvertInterfaceNameToLuidA

NET_LUID