ConvertInterfaceLuidToAlias függvény

A ConvertInterfaceLuidToAlias függvény egy helyileg egyedi azonosítót (LUID) alakít át egy hálózati adapter aliasává.

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 ConvertInterfaceLuidToAlias(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       PWSTR    InterfaceAlias,
  _In_        SIZE_T   Length
);

Paraméterek

• InterfaceLuid [in]
  Egy NET_LUID egyesítésre mutató mutató a hálózati adapterhez.

• InterfaceAlias [ki]
  A NULL értékű Unicode-sztring tárolására mutató mutató egy pufferre. Ha ConvertInterfaceLuidToAlias sikeresen visszatér, InterfaceAlias tartalmazza a hálózati adapter aliasnevét.

• Hossz [in]
  A InterfaceAlias paraméter által megadott puffer hossza karakterszám szerint. Ennek az értéknek elég nagynak kell lennie ahhoz, hogy a hálózati adapter aliasnevé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

ConvertInterfaceLuidToAlias visszaadja STATUS_SUCCESS, ha a függvény sikeres. Ha a függvény meghiúsul, ConvertInterfaceLuidToAlias 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. ConvertInterfaceLuidToAlias ezt a hibát adja vissza, ha InterfaceLuid vagy InterfaceAliasNULL, vagy ha InterfaceLuid érvénytelen.
STATUS_NOT_ENOUGH_MEMORY	Nincs elegendő tárterület. ConvertInterfaceLuidToAlias akkor adja vissza ezt a hibát, ha az InterfaceAlias paraméterpontok által megadott puffer mérete nem volt olyan nagy, mint a Hossz paraméterben megadva, ezért a puffer nem tudta tartani az aliasnevet.

Megjegyzések

A ConvertInterfaceLuidToAlias függvény protokollfüggetlen, és az IPv6 és az IPv4 protokollok hálózati adaptereivel is működik.

A hálózati adapter aliasnevének maximális hossza (NDIS_IF_MAX_STRING_SIZE, null karakter nélkül) deklarálva van az Ntddndis.h fejlécfájlban. NDIS_IF_MAX_STRING_SIZE IF_MAX_STRING_SIZE állandóként van definiálva, amely az Ifdef.h fejlécfájlban 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.

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

Lásd még:

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID