Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A ConvertInterfaceLuidToNameW függvény egy helyileg egyedi azonosítót (LUID) konvertál egy hálózati adapterhez Unicode-interfésznévvé.
Jegyzet
A ConvertInterfaceXxx API-család számba adja a TCP/IP-hez kötött összes adapter azonosítóit, amelyek virtuális miniportokat, egyszerűsített szűrőket, alagútadaptereket és fizikai adaptereket tartalmazhatnak.
Szintaxis
NETIOAPI_API ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Paraméterek
InterfaceLuid [in]
Egy NET_LUID egyesítésre mutató mutató a hálózati adapterhez.InterfaceName [ki]
A NULL értékű Unicode-sztring tárolására mutató mutató egy pufferre. Ha ConvertInterfaceLuidToNameW sikeresen visszatér, InterfaceName tartalmazza a Unicode-felület nevét.Hossz [in]
Annak a puffernek a hossza karakterszám szerint, amelyre a InterfaceName paraméter mutat. Ennek az értéknek elég nagynak kell lennie ahhoz, hogy az illesztő nevét és a végződő NULL karaktert tartsa. A megengedett legnagyobb hossz NDIS_IF_MAX_STRING_SIZE + 1. A NDIS_IF_MAX_STRING_SIZE kapcsolatos további információkért tekintse meg a következő Megjegyzések szakaszt.
Visszaadott érték
ConvertInterfaceLuidToNameW a függvény sikeres működése esetén STATUS_SUCCESS ad vissza. Ha a függvény meghiúsul, ConvertInterfaceLuidToNameW a következő hibakódok egyikét adja vissza:
| Kód visszaadása | Leírás |
|---|---|
| STATUS_INVALID_PARAMETER | Az egyik paraméter érvénytelen. ConvertInterfaceLuidToNameW akkor adja vissza ezt a hibát, ha InterfaceLuid vagy InterfaceNameNULL, vagy ha InterfaceLuid érvénytelen. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW akkor adja vissza ezt a hibát, ha a InterfaceName puffer nem volt olyan nagy, mint a Hossz paraméterben megadva, ezért a puffer nem tudta tárolni a felület nevét. |
Megjegyzések
A ConvertInterfaceLuidToNameW függvény protokollfüggetlen, és az IPv6 és az IPv4 protokollok hálózati adaptereivel is működik.
Az Ntddndis.h fejlécfájlban a hálózati adapter nevének maximális hossza (NDIS_IF_MAX_STRING_SIZE, null karakter nélkül). A NDIS_IF_MAX_STRING_SIZE az Ifdef.h fejlécfájlban definiált IF_MAX_STRING_SIZE állandóként van definiálva.
Jegyzet
Az Ntddndis.h és Ifdef.h fejlécfájl automatikusan bekerül a Netioapi.h fejlécfájlba. Soha ne használja közvetlenül az Ntddndis.h és Ifdef.h fejlécfájlokat.
A ConvertInterfaceLuidToNameA használatával alakítsa át a hálózati adapter LUID azonosítóját ANSI-adapternévvé.
Követelmények
Célplatform |
Univerzális |
Verzió |
Elérhető a Windows Vista és a Windows operációs rendszerek újabb verzióiban. |
Fejléc |
Netioapi.h (netioapi.h) |
Könyvtár |
Netio.lib |
IRQL |
PASSIVE_LEVEL |