ConvertInterfaceLuidToNameA işlevi

ConvertInterfaceLuidToNameA işlevi, ağ arabirimi için yerel olarak benzersiz bir tanımlayıcıyı (LUID) ANSI arabirim adına dönüştürür.

Not

ConvertInterfaceXxx API ailesi, TCP/IP'ye bağlı tüm arabirimler üzerinde tanımlayıcıları numaralandırır. Bu, sanal miniport'lar, basit filtreler, tünel bağdaştırıcıları ve fiziksel arabirimler içerebilir.

Sözdizimi

NETIOAPI_API ConvertInterfaceLuidToNameA(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PSTR     InterfaceName,
  _In_        SIZE_T   Length
);

Parametre

• InterfaceLuid [in]
  Ağ arabirimi için NET_LUID birleşimine yönelik bir işaretçi.

• InterfaceName [out]
  NULL ile sonlandırılan ANSI dizesini tutmak için arabelleğe yönelik bir işaretçi. ConvertInterfaceLuidToNameA başarıylaInterfaceName ANSI arabirim adını içerir.

• Uzunluğu [in]
  interfaceName parametresinin işaret arabelleğin bayt cinsinden uzunluğu. Bu değer, arabirim adını ve sonlandırıcı NULL karakterini barındıracak kadar büyük olmalıdır. İzin verilen maksimum uzunluk NDIS_IF_MAX_STRING_SIZE + 1'dir. NDIS_IF_MAX_STRING_SIZE hakkında daha fazla bilgi için aşağıdaki Açıklamalar bölümüne bakın.

Dönüş değeri

convertInterfaceLuidToNameA işlevi başarılı olursa STATUS_SUCCESS döndürür. İşlev başarısız olursa ConvertInterfaceLuidToNameA aşağıdaki hata kodlarından birini döndürür:

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	Parametrelerden biri geçersiz. ConvertInterfaceLuidToNameA, InterfaceLuid veya InterfaceNameNULLise veya InterfaceLuid geçersizse bu hatayı döndürür.
STATUS_NOT_ENOUGH_MEMORY	ConvertInterfaceLuidToNameA, InterfaceName arabelleği Length parametresinde belirtilen kadar büyük değilse ve bu nedenle arabellek arabirim adını tutamadıysa bu hatayı döndürür.

Açıklamalar

ConvertInterfaceLuidToNameA işlevi protokolden bağımsızdır ve hem IPv6 hem de IPv4 protokolleri için ağ arabirimleriyle çalışır.

Sonlandırıcı NULL karakteri olmadan NDIS_IF_MAX_STRING_SIZE bir ağ arabiriminin adının en uzun uzunluğu Ntddndis.h üst bilgi dosyasında tanımlanır. 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.

Ağ arabirimi LUID'sini Unicode arabirim adına dönüştürmek için ConvertInterfaceLuidToNameWişlevini kullanın.

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.

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID