ConvertInterfaceNameToLuidW işlevi

ConvertInterfaceNameToLuidW işlevi, unicode ağ arabirimi adını arabirim için yerel olarak benzersiz tanımlayıcıya (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 ConvertInterfaceNameToLuidW(
  _In_  const WCHAR    *InterfaceName,
  _Out_       NET_LUID *InterfaceLuid
);

Parametre

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

• InterfaceLuid [out]
  Bu arabirim için NET_LUID birleşimine yönelik bir işaretçi.

Dönüş değeri

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

İade kodu	Açıklama
STATUS_INVALID_NAME	Arabirim adı geçersiz. ConvertInterfaceNameToLuidW, InterfaceName parametresi geçersiz bir ad içeriyorsa veya InterfaceName parametresinin uzunluğu bu parametre için izin verilen en fazla dize uzunluğunu aşıyorsa bu hatayı döndürür.
STATUS_INVALID_PARAMETER	Parametrelerden biri geçersiz. InterfaceLuid parametresi NULL ise ConvertInterfaceNameToLuidW bu hatayı döndürür.

Açıklamalar

ConvertInterfaceNameToLuidW 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 ağ arabirimi adının uzunluk üst sınırı 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.

ANSI arabirim adını LUID'ye dönüştürmek için ConvertInterfaceNameToLuidA iş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

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

NET_LUID