Função ConvertInterfaceGuidToLuid
A função ConvertInterfaceGuidToLuid converte um GUID (identificador global exclusivo) para um adaptador de rede para o LUID (identificador local exclusivo) para a interface.
Nota
A família de APIXxx enumera identificadores em todas as interfaces associadas ao TCP/IP, que podem incluir miniportos virtuais, filtros leves, adaptadores de túnel e interfaces físicas.
Sintaxe
NETIOAPI_API ConvertInterfaceGuidToLuid(
_In_ const GUID *InterfaceGuid,
_Out_ PNET_LUID InterfaceLuid
);
Parâmetros
InterfaceGuid [in]
Um ponteiro para um GUID para o adaptador de rede.InterfaceLuid [out]
Um ponteiro para a união NET_LUID para o adaptador de rede.
Valor de retorno
ConvertInterfaceGuidToLuid retornará STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, o parâmetro InterfaceLuid será definido como NULL e ConvertInterfaceGuidToLuid retornará o seguinte código de erro:
Código de retorno | Descrição |
---|---|
STATUS_INVALID_PARAMETER | Um dos parâmetros era inválido. ConvertInterfaceGuidToLuid retornará esse erro se interfaceAlias ou InterfaceLuid for NULL ou se InterfaceGuid for inválido. |
Observações
A função ConvertInterfaceGuidToLuid é independente de protocolo e funciona com interfaces de rede para os protocolos IPv6 e IPv4.
Requisitos
Plataforma de destino |
Universal |
Versão |
Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
Cabeçalho |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |