ConvertInterfaceLuidToAlias işlevi

ConvertInterfaceLuidToAlias işlevi, ağ arabirimi için yerel olarak benzersiz bir tanımlayıcıyı (LUID) arabirim diğer 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 ConvertInterfaceLuidToAlias(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceAlias,
  _In_        SIZE_T   Length
);

Parametre

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

• InterfaceAlias [out]
  NULL ile sonlandırılan Unicode dizesini tutan bir arabelleğe işaretçi. ConvertInterfaceLuidToAlias başarıyla döndürülüyorsa, InterfaceAlias ağ arabiriminin diğer adını içerir.

• Uzunluğu [in]
  InterfaceAlias parametresinin işaret ettiği arabelleğin karakter sayısına göre uzunluğu. Bu değer, ağ arabiriminin diğer 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

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

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	Parametrelerden biri geçersiz. ConvertInterfaceLuidToAlias, InterfaceLuid veya InterfaceAliasNULLise veya InterfaceLuid geçersizse bu hatayı döndürür.
STATUS_NOT_ENOUGH_MEMORY	Yeterli depolama alanı yok. ConvertInterfaceLuidToAlias, InterfaceAlias parametresinin işaret arabelleğinin boyutu Uzunluğu parametresinde belirtilen kadar büyük değilse ve bu nedenle arabellek diğer adı tutamadıysa bu hatayı döndürür.

Açıklamalar

ConvertInterfaceLuidToAlias 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ğ arabirimi için diğer ad adının en uzun uzunluğu, 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.

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

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID