ConvertInterfaceAliasToLuid işlevi

ConvertInterfaceAliasToLuid işlevi, ağ arabiriminin arabirim diğer adını arabirimin yerel olarak benzersiz tanımlayıcısına (LUID) 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 ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Parametre

• InterfaceAlias [in]
  Ağ arabiriminin diğer adını içeren NULL ile sonlandırılan Unicode dizesini gösteren bir işaretçi.

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

Dönüş değeri

ConvertInterfaceAliasToLuid işlevi başarılı olursa STATUS_SUCCESS döndürür. İşlev başarısız olursa, InterfaceLuid parametresi NULL olarak ayarlanır ve ConvertInterfaceAliasToLuid aşağıdaki hata kodunu döndürür:

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	Parametrelerden biri geçersizdi. ConvertInterfaceAliasToLuidInterfaceAlias veya InterfaceLuidNULLise veya InterfaceAlias geçersizse bu hatayı döndürür.

Açıklamalar

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

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.

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID