Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
ConvertInterfaceLuidToNameW işlevi, ağ arabirimi için yerel olarak benzersiz bir tanımlayıcıyı (LUID) Unicode 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 ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR 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 Unicode dizesini tutan bir arabelleğe işaretçi. ConvertInterfaceLuidToNameW başarıyla döndürülüyorsa, InterfaceName Unicode arabirim adını içerir.Uzunluğu [in]
InterfaceName parametresinin işaret ettiği karakter sayısına göre arabellek 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
convertInterfaceLuidToNameW işlevi başarılı olursa STATUS_SUCCESS döndürür. İşlev başarısız olursa ConvertInterfaceLuidToNameW aşağıdaki hata kodlarından birini döndürür:
| İade kodu | Açıklama |
|---|---|
| STATUS_INVALID_PARAMETER | Parametrelerden biri geçersiz. ConvertInterfaceLuidToNameWInterfaceLuid veya InterfaceNameNULLise veya InterfaceLuid geçersizse bu hatayı döndürür. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW, 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
ConvertInterfaceLuidToNameW 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.
Ağ arabirimi LUID'sini ANSI arabirim adına dönüştürmek için ConvertInterfaceLuidToNameAkullanı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 |