Função ConvertInterfaceLuidToGuid
A função ConvertInterfaceLuidToGuid converte um LUID (identificador local exclusivo) para um adaptador de rede em um GUID (identificador global exclusivo) para a interface.
Observação
A família de API ConvertInterfaceXxx 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 ConvertInterfaceLuidToGuid(
_In_ const NET_LUID *InterfaceLuid,
_Out_ GUID *InterfaceGuid
);
Parâmetros
InterfaceLuid [in]
Um ponteiro para uma união de NET_LUID para o adaptador de rede.InterfaceGuid [out]
Um ponteiro para o GUID para o adaptador de rede.
Retornar valor
ConvertInterfaceLuidToGuid retornará STATUS_SUCCESS se a função for bem-sucedida. Se a função falhar, o parâmetro InterfaceGuid será definido como NULL e ConvertInterfaceLuidToGuid retornará o seguinte código de erro:
| Código de retorno | Descrição |
|---|---|
| STATUS_INVALID_PARAMETER | Um dos parâmetros é inválido. ConvertInterfaceLuidToGuid retornará esse erro se InterfaceLuid ou InterfaceGuid for NULL ou se InterfaceLuid for inválido. |
Comentários
A função ConvertInterfaceLuidToGuid é 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. |
parâmetro |
Netioapi.h (inclua Netioapi.h) |
Biblioteca |
Netio.lib |
IRQL |
PASSIVE_LEVEL |