ConvertInterfaceAliasToLuid függvény

A ConvertInterfaceAliasToLuid függvény átalakítja a hálózati adapter aliasnevét az adapter helyileg egyedi azonosítójának (LUID) nevére.

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 ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Paraméterek

• InterfaceAlias [in]
  Mutató egy NULL-végződésű Unicode-sztringre, amely tartalmazza a hálózati adapter aliasnevét.

• InterfaceLuid [ki]
  A hálózati adapter NET_LUID egyesítésére mutató mutató.

Visszaadott érték

ConvertInterfaceAliasToLuid a függvény sikeres működése esetén STATUS_SUCCESS ad vissza. Ha a függvény meghiúsul, a InterfaceLuid paraméter értéke NULL, és ConvertInterfaceAliasToLuid a következő hibakódot adja vissza:

Kód visszaadása	Leírás
STATUS_INVALID_PARAMETER	Az egyik paraméter érvénytelen volt. ConvertInterfaceAliasToLuid akkor adja vissza ezt a hibát, ha InterfaceAlias vagy InterfaceLuidNULL, vagy ha InterfaceAlias érvénytelen.

Megjegyzések

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

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:

ConvertInterfaceGuidToLuid

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID