ConvertInterfaceGuidToLuid işlevi

ConvertInterfaceGuidToLuid işlevi, ağ arabirimi için genel olarak benzersiz bir tanımlayıcıyı (GUID) 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 ConvertInterfaceGuidToLuid(
  _In_  const GUID      *InterfaceGuid,
  _Out_       PNET_LUID InterfaceLuid
);

Parametre

• InterfaceGuid [in]
  Ağ arabirimi için GUID işaretçisi.

• InterfaceLuid [out]
  Ağ arabirimi için NET_LUID birleşimine yönelik bir işaretçi.

Dönüş değeri

convertInterfaceGuidToLuid işlevi başarılı olursa STATUS_SUCCESS döndürür. İşlev başarısız olursa, InterfaceLuid parametresi NULL olarak ayarlanır ve ConvertInterfaceGuidToLuid aşağıdaki hata kodunu döndürür:

İade kodu	Açıklama
STATUS_INVALID_PARAMETER	Parametrelerden biri geçersizdi. ConvertInterfaceGuidToLuid, InterfaceAlias veya InterfaceLuid NULL ise veya InterfaceGuid geçersizse bu hatayı döndürür.

Açıklamalar

ConvertInterfaceGuidToLuid işlevi protokolden bağımsızdır ve hem IPv6 hem de IPv4 protokolleri için ağ arabirimleriyle çalışır.

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

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID